- DWORD dispRegisterService ( const char *svcname,
unsigned svcid,
const char *svcmgrname,
const CTAINTREV_INFO *previnfo,
const CTAREQSVC_INFO preqsvc [],
unsigned nreqsvcs,
const CTAPARM_DESC *const *stdparmdesc,
const CTAPARM_DESC *const *extparmdesc)
- svcname Pointer to the name of the service.
- svcid Service identifier used in commands, errors, reasons, and events (this is assigned by NMS).
- svcmgrname Pointer to the service manager name.
- previnfo Pointer to the service revision information structure which contains the following fields:
typedef struct
{
DWORD size; /*size of the structure */
DWORD majorrev /*major revision of service/manager */
DWORD minorrev; /*minor revision of service/manager */
char buildate [12]; /*build date, "mmm dd yyyy\0" */
DWORD reqdisplevel; /*Required compat level of dispatcher */
DWORD expapilevel; /*Exported compat level of Service API */
DWORD expspilevel; /*Exported compat level of Service SPI */
} CTAINTREV_INFO;
- preqsvc Pointer to array of structures containing information on services required by this service:
typedef struct
{
char *svcname; /* Name of required service. */
DWORD svcid; /* Service ID of required service. */
DWORD reqspilevel; /* Required compat level of Service SPI */
} CTAREQSVC_INFO;
- nreqsvcs Number of required service structures in preqsvc.
- stdparmdesc Pointer to an array of pointers to standard parameter descriptors that will be managed for the service by Natural Access. The array is terminated with a NULL character. Each parameter descriptor structure in the array has the following definition:
typedef struct
{
DWORD parm_id;
void *parm; /*Pointer to defaults (binary) */
const CTAPARM_FIELD *descr; /*Pointer to field descriptor */
DWORD fieldcnt; /*Number of fields in descr */
} CTAPARM_DESC;
- Field descriptors referenced above have the following definition:
typedef struct
{
char *name; /* Name of the field. */
DWORD offset; /* Byte offset from base or # of fields */
/* if received zero (0) in array. */
DWORD size; /* Size of the field. */
DWORD format; /* Format specifier. */
DWORD units; /* Units specifier. */
} CTAPARM_FIELD;
Note: These structures are automatically generated by pf2src from a .pf file.
- extparmdesc Pointer to an array of pointers to non-standard (extension) parameter descriptors that will be managed for the service by Natural Access. The array is terminated with a null character. The structure is defined above.
(Page 16 of 36 in this chapter) Version