Requests a control buffer from the service pool.

LPCONTROLBUFFER RequestControlBuffer(
    LPSERVICEDESC lpServiceDescriptor,
);

Parameters

lpServiceDescriptor

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

Return Values

Returns a pointer to it, or else a null pointer if the pool is empty. The function requires a pointer to the service descriptor to which the pool belongs.

Status

E_CONTEXT 0x0005

The service is being uninstalled.

E_EXIST 0x0006

The lpServiceDescriptor parameter is not a pointer to a valid SERVICEDESC structure.

E_RESOURCE_LIMIT 0x00E6

There are no control buffers available.

E_TYPE 0x8002

The SERVICEDESC structure is corrupt.

Requirements

See Also

RT Service system calls, SERVICEDESC