GetNamedPipeTransactionSpecific

The GetNamedPipeTransactionSpecific function retrieves the transaction identifier associated with a named pipe.

Syntax

BOOL GetNamedPipeTransactionSpecific(
  HANDLE                hNamedPipe,
  LPGUID                lpvTransaction,
  LPDWORD               lpdwTransactionState
);

Parameters

hNamedPipe: A handle to the named pipe.
lpvTransaction: A pointer to a GUID structure that receives the transaction identifier.
lpdwTransactionState: A pointer to a DWORD that receives the state of the transaction. This can be one of the following values:
- TRANSACTION_STATE_UNKNOWN
- TRANSACTION_STATE_ACTIVE
- TRANSACTION_STATE_COMMITTED
- TRANSACTION_STATE_ABORTED

Return value

If the function succeeds, the return value is nonzero. If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

This function is used to determine if a named pipe is associated with a distributed transaction and to retrieve the transaction's identifier and state.

Note: This function requires the pipe to be created with transactional support enabled.

Requirements