GetNotificationResourceManager 함수(ktmw32.h)

아티클
02/28/2024

RM(리소스 관리자)에 대한 알림을 요청하고 받습니다. 이 함수는 트랜잭션 상태가 변경될 때 RM 레지스터에서 알림을 받는 데 사용됩니다.

구문

BOOL GetNotificationResourceManager(
  [in]            HANDLE                    ResourceManagerHandle,
  [out]           PTRANSACTION_NOTIFICATION TransactionNotification,
  [in]            ULONG                     NotificationLength,
  [in, optional]  DWORD                     dwMilliseconds,
  [out, optional] PULONG                    ReturnLength
);

매개 변수

[in] ResourceManagerHandle

리소스 관리자에 대한 핸들입니다.

[out] TransactionNotification

사용 가능한 첫 번째 알림을 받는 TRANSACTION_NOTIFICATION 구조체에 대한 포인터입니다.

[in] NotificationLength

TransactionNotification 버퍼의 크기(바이트)입니다.

[in, optional] dwMilliseconds

알림을 사용할 수 있길 기다리는 동안 호출 애플리케이션이 차단되는 시간(밀리초)입니다. 시간 제한이 만료되면 알림을 사용할 수 없는 경우 ERROR_TIMEOUT 반환됩니다.

[out, optional] ReturnLength

TransactionNotification 매개 변수에서 받은 알림의 실제 크기를 수신하는 변수에 대한 포인터입니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError 함수를 호출합니다.

다음 목록에서는 가능한 오류 코드를 식별합니다.

설명

모든 리소스 관리자는 등록하여 TRANSACTION_NOTIFY_PREPREPARE, TRANSACTION_NOTIFY_PREPARE 및 TRANSACTION_NOTIFY_COMMIT 알림을 수신해야 합니다. 리소스 관리자는 TRANSACTION_NOTIFY_SINGLE_PHASE_COMMIT 지원할 수 있지만 다단계 사전 준비, 준비 및 커밋 알림도 지원해야 합니다. 리소스 관리자가 받을 수 있는 모든 알림 목록은 TRANSACTION_NOTIFICATION 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	ktmw32.h
라이브러리	KtmW32.lib
DLL	KtmW32.dll