Returns a control buffer to the service pool. You should invoke this call only to clean up explicitly on certain error-handling conditions. Control buffers are normally automatically released on calling DeliverMessage, DeliverTransaction, or DeliverStatus.

BOOLEAN ReleaseControlBuffer(
    LPSERVICEDESC lpServiceDescriptor,
    LPCONTROLBUFFER lpControlBuffer
);

Parameters

xlpServiceDescriptor

A pointer to a SERVICEDESC structure. The service must have been installed.

lpControlBuffer

A pointer to a CONTROLBUFFER previously allocated from this service.

Return Values

TRUE

Success.

FALSE

Failure. To determine the status, call GetLastRtError.

Status

E_CONTEXT 0x0005

The service is being uninstalled.

E_EXIST 0x0006

The lpServiceDescriptor parameter is not a pointer to a valid SERVICEDESC

E_TYPE 0x8002

The SERVICEDESC structure is corrupt.

E_NUC_BAD_BUF 0x80E2

The lpControlBuffer parameter is not a valid pointer.

Requirements

See Also

RT Service system calls, DeliverMessage, DeliverTransaction, DeliverStatus, SERVICEDESC, CONTROLBUFFER