INtime SDK Help
InstallRtServiceDescriptor (deprecated)

From INtime 6.0 the INtime Service and Port objects have been deprecated.

New projects should not be started using these features, and existing projects will not work with XM mode. You will receive a compiler warning by default if you use these calls.

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

Versions Defined in Include Link to
INtime 3.0 intime/rt/include/rtbase.h rt.h rt.lib

See Also

Port system calls, Initialize