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