Enqueues a transaction on either the service or a port input queue.

BOOLEAN EnqueueInputTransaction(
    RTHANDLE hObject,
    LPTRANSACTION lpTrans,
    BOOLEAN *lpbEmpty
);

Parameters

hObject

A handle for either a service or a port. The service handle is inserted into the service descriptor after installation.

lpTrans

A pointer to a TRANSACTION structure.

lpbEmpty

A pointer to a BOOLEAN location where the call returns the queue status.

Return Values

TRUE. The location pointed-to by lpbEmpty will contain TRUE if the queue was empty, FALSE otherwise.

Success.

FALSE

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_STATE 0x0007

The transaction is already present on an output queue.

E_TYPE 0x8002

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

E_NUC_BAD_BUF 0x80E2

The lpTransaction parameter contains an invalid pointer.

Requirements

See Also

RT Service system calls, TRANSACTION