INtime SDK Help
UninstallRtServiceDescriptor (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.

Removes a service from the operating system by unlinking the service descriptor from the service descriptor list. It performs any cleaning up required to ensure a clean shutdown of the service. All ports currently open in this service are closed and any system resources allocated internally are released. If a pFinish entry is present in the service descriptor, a call is made to it before returning from this call.

BOOLEAN UninstallRtServiceDescriptor(
    LPSTR lpzServiceName        // a pointer to the name of a service descriptor
);

Parameters

lpzServiceName
The name of the service descriptor to remove.

Return Values

TRUE
Success.
FALSE
Failure. To determine the status, call GetLastRtError.

Status

E_OK 0x0000
No exceptional conditions occurred.
E_CONTEXT 0x0005
A service with the given name was not found.
E_EXIST 0x0006
The service is already being uninstalled.
E_NUC_BAD_BUF 0x80E2
An invalid pointer was supplied.

Requirements

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