Adds a service to the operating system by linking the service descriptor to the service descriptor list.

BOOLEAN InstallRtServiceDescriptor(
  LPSERVICEDESC lpServiceDescriptor    // a pointer to a service descriptor
);

Parameters

lpServiceDescriptor

A pointer to the SERVICEDESC structure.

Return Values

TRUE

Success.

FALSE

Failure. To determine the status, call GetLastRtError.

Status

E_OK 0x0000

No exceptional conditions occurred.

E_MEM 0x0002

Insufficient physical memory is available to the calling thread's process.

E_LIMIT 0x0004

The calling thread's process has already reached its object limit.

E_SLOT 0x000c

There is no room in the GDT to create the objects associated with this service.

E_VMEM 0x00F0

There is insufficient virtual memory in the process' VSEG.

E_PARAM 0x8004

One of these conditions exist:

• The maximum port ID value specified in the service descriptor was greater than the port table size.
• An invalid bit was set in the wServiceFlags field of the service descriptor.

E_NUC_BAD_BUF 0x80E2

An invalid pointer to the service descriptor was supplied.

E_LOCATION

The RT client on which the port was created is now invalid.

Note:   Other status values may be generated by the service-specific Initialize handler.

Requirements

See Also

Port system calls, Initialize