Opens a conferencing resource and obtains a conferencing resource handle.

DWORD cnfOpenResource ( CTAHD ctahd,
unsigned resourcenum,
CNFRESOURCEHD *cnfresourcehd)

ctahd CTA context handle returned by ctaCreatecontext.

resourcenum Conferencing resource number as declared in the NaturalConference configuration file (cnf.cfg).

cnfresourcehd Pointer to a returned conferencing resource handle.

• SUCCESS
• CTAERR_BAD_ARGUMENT
  cnfresourcehd is a NULL pointer.
• CTAERR_BOARD_ERROR
  The resource has been defined in the cnf.cfg, but the corresponding DSPs have not been loaded by the configuration utility.
• CTAERR_INVALID_CTAHD
  ctahd is not a valid handle.
• CNFERR_BOARD_TIMEOUT
  The board timed out while waiting for a response message.
• CNFERR_CANNOT_CREATE_CHANNEL
  No AG communication channels are available for use on the specified resource.
• CNFERR_RESOURCE_NOT_AVAILABLE
  The resource number designated by resourcenum does not exist or is not available.
• CNFERR_RESOURCE_NOT_DEFINED
  The resource is not defined in the NaturalConference configuration file (cnf.cfg).

• CNFEVN_OPEN_RESOURCE_DONE
  The function completed successfully and a new resource handle was allocated.

This function opens a new conferencing resource handle on the resource specified by resourcenum. Many handles can be opened on the same conferencing resource. This handle is required for every other function in NaturalConference. Wait for the CNFEVN_OPEN_RESOURCE_DONE event before using the cnfresourcehd (especially important when using the Server mode of CT Access).

For more information, refer to Section 4.5, Creating Conferences.

cnfCloseResource, cnfGetResourceInfo

extern CTAHD              ctahd;
extern CTAQUEUEHD         qhd;
   
DWORD myOpenResource(unsigned resnum)
{
  CNFRESOURCEHD newcnfresourcehd;
  DWORD error;
  CTA_EVENT evt;
  char  textbuf[80] = "";

   error = cnfOpenResource (ctahd,  resnum,  &newcnfresourcehd);
   if (error != SUCCESS)
   {
   }
       do
   {
       error = ctaWaitEvent( qhd, &evt, CTA_WAIT_FOREVER );
    if(error != SUCCESS)
    {
     ctaGetText( ctahd, error, textbuf, sizeof( textbuf ) );
     printf( "\rError when calling ctaWaitEvent => %s\n",
      textbuf);
     return(error);
    }
    } while ( evt.id != CNFEVN_OPEN_RESOURCE_DONE );