Função TmDereferenceEnlistmentKey (wdm.h)
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 |
|---|---|
|
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 |