TmDereferenceEnlistmentKey 함수(wdm.h)

TmDereferenceEnlistmentKey 루틴은 지정된 인리스트먼트 개체의 키에 대한 참조 수를 감소합니다.

구문

NTSTATUS TmDereferenceEnlistmentKey(
  [in]            PKENLISTMENT Enlistment,
  [out, optional] PBOOLEAN     LastReference
);

[in] Enlistment

인리스트먼트 개체에 대한 포인터입니다. 구성 요소는 ResourceManagerNotification 콜백 루틴에 대한 입력으로 이 포인터를 받을 수 있습니다. 또는 구성 요소가 ObReferenceObjectByHandle을 호출하고 ZwCreateEnlistment, TmCreateEnlistment 또는 ZwOpenEnlistment에 대한 이전 호출이 제공된 개체 핸들을 제공할 수 있습니다.

[out, optional] LastReference

BOOLEAN 형식 변수에 대한 포인터입니다. 이 변수는 TmDereferenceEnlistmentKey가 감소한 후 참조 수가 0이면 TRUE를 받습니다. 그렇지 않으면 변수는 FALSE를 받습니다.

TmDereferenceEnlistmentKey 는 작업이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 이 루틴이 다음 값 중 하나를 반환할 수 있습니다.

반환 코드	설명
STATUS_UNSUCCESSFUL	지정된 인리스트먼트 개체의 참조 수는 0이며 감소할 수 없습니다.

루틴은 다른 NTSTATUS 값을 반환할 수 있습니다.

TmReferenceEnlistmentKey 루틴은 인리스트먼트 개체의 키에 대한 참조 수를 증가시키고 TmDereferenceEnlistmentKey 루틴은 개수를 감소합니다.

Zw Xxx 루틴 대신 KTM의 TmXxx 루틴을 사용하는 시기에 대한 자세한 내용은 TmXxx 루틴 사용을 참조하세요.

요구 사항	값
지원되는 최소 클라이언트	Windows Vista 이상 운영 체제 버전에서 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함)
라이브러리	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL