Função TmDereferenceEnlistmentKey (wdm.h)

Artigo
03/01/2024

A rotina TmDereferenceEnlistmentKey diminui a contagem de referência para a chave de um objeto de inscrição especificado.

Sintaxe

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

Parâmetros

[in] Enlistment

Um ponteiro para um objeto de inscrição. Seu componente pode receber esse ponteiro como entrada para uma rotina de retorno de chamada ResourceManagerNotification . Como alternativa, seu componente pode chamar ObReferenceObjectByHandle e fornecer o identificador de objeto fornecido por uma chamada anterior para ZwCreateEnlistment, TmCreateEnlistment ou ZwOpenEnlistment .

[out, optional] LastReference

Um ponteiro para uma variável do tipo BOOLEAN. Essa variável receberá TRUE se a contagem de referência for zero após TmDereferenceEnlistmentKey decrementá-la. Caso contrário, a variável receberá FALSE.

Retornar valor

TmDereferenceEnlistmentKey retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, essa rotina pode retornar um dos seguintes valores:

Código de retorno	Descrição
STATUS_UNSUCCESSFUL	A contagem de referência do objeto de inscrição especificado é zero e não pode ser decrementada.

A rotina pode retornar outros valores NTSTATUS.

Comentários

A rotina TmReferenceEnlistmentKey incrementa a contagem de referência para a chave de um objeto de inscrição e a rotina TmDereferenceEnlistmentKey diminui a contagem.

Para obter informações sobre quando usar as rotinas TmXxx da KTM em vez de rotinas ZwXxx , consulte Usando rotinas TmXxx.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows Vista e versões posteriores do sistema operacional.
Plataforma de Destino	Universal
Cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL