CreateResourceManager 함수(ktmw32.h)

새 RM(리소스 관리자) 개체를 만들고 RM을 TM(트랜잭션 관리자)과 연결합니다.

구문

HANDLE CreateResourceManager(
  [in, optional] LPSECURITY_ATTRIBUTES lpResourceManagerAttributes,
  [in]           LPGUID                ResourceManagerId,
  [in, optional] DWORD                 CreateOptions,
  [in]           HANDLE                TmHandle,
  [in, optional] LPWSTR                Description
);

매개 변수

[in, optional] lpResourceManagerAttributes

리소스 관리자의 보안 특성을 포함하는 SECURITY_ATTRIBUTES 구조체에 대한 포인터입니다. NULL을 지정하여 기본 특성을 가져옵니다.

[in] ResourceManagerId

리소스 관리자 GUID를 가리키는 포인터입니다. 이 매개 변수는 필수이며 NULL이 아니어야 합니다.

[in, optional] CreateOptions

새 RM에 대한 선택적 특성입니다.

값	의미
RESOURCE_MANAGER_VOLATILE	RM이 휘발성이며 복구를 수행하지 않음을 나타냅니다.

[in] TmHandle

이 RM에 대한 트랜잭션을 관리하는 TM에 대한 핸들입니다.

[in, optional] Description

이 RM에 대한 설명입니다.

반환 값

함수가 성공하면 반환 값은 RM에 대한 핸들입니다.

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

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

설명

이 함수를 호출한 직후 RecoverResourceManager를 호출해야 합니다.

RM은 RM이 참여한 트랜잭션에 대한 TM 알림의 엔드포인트입니다.

RM은 일반적으로 영구적입니다. 즉, 시스템 오류가 발생한 후 특정 작업을 수행하려면 RM을 다시 열어야 합니다. CreateResourceManager 함수를 호출하고 RESOURCE_MANAGER_VOLATILE 지정하여 일시적 또는 일시적 RM을 만들 수 있습니다. 휘발성 RM은 복구 작업을 수행하지 않지만 트랜잭션에 대한 알림이 필요합니다.

지속성 TM에서 휘발성 RM을 만들 수 있지만 휘발성 TM에 지속성 RM을 만들 수는 없습니다.

요구 사항

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

추가 정보

커널 트랜잭션 관리자 함수

OpenResourceManager

SECURITY_ATTRIBUTES

SetResourceManagerCompletionPort