Dequeues the transaction at the head of the service input queue and returns a pointer to it.

LPTRANSACTION DequeueInputTransaction(
    RTHANDLE hObject
);

Parameters

hObject

A handle for either a service or a port.

Return Values

A valid pointer to a TRANSACTION structure, or NULL if queue was empty.

Success.

BAD_POINTER

Failure. To determine the status, call GetLastRtError.

Status

E_CONTEXT 0x0005

The port is being deleted or the service is being uninstalled.

E_EXIST 0x0006

The hObject parameter is not a valid handle.

E_TYPE 0x8002

The hObject parameter is not a handle for a port or a service.

Requirements

See Also

RT Service system calls, TRANSACTION