Função NmrWaitForClientDeregisterComplete (netioddk.h)

  • Artigo

A função NmrWaitForClientDeregisterComplete aguarda a conclusão do cancelamento do registro de um módulo cliente.

Sintaxe

NTSTATUS NmrWaitForClientDeregisterComplete(
  [in] HANDLE NmrClientHandle
);

Parâmetros

[in] NmrClientHandle

Um identificador usado pela NMR para representar o registro do módulo cliente. O NMR retorna esse identificador para o módulo cliente quando o módulo cliente chama a função NmrRegisterClient .

Retornar valor

A função NmrWaitForClientDeregisterComplete retorna um dos seguintes códigos NTSTATUS:

Código de retorno Descrição
STATUS_SUCCESS
 A NMR concluiu a desregistro do módulo cliente.
STATUS_INVALID_PARAMETER
 O módulo cliente chamou a função NmrWaitForClientDeregisterComplete antes de chamar a função NmrDeregisterClient ou o identificador especificado no parâmetro NmrClientHandle não é um identificador de cliente válido.
Outros códigos status
 Ocorreu um erro.

Comentários

Um módulo cliente chama a função NmrWaitForClientDeregisterComplete para aguardar a conclusão do cancelamento do registro do módulo cliente. Um módulo cliente chama a função NmrWaitForClientDeregisterComplete somente depois de chamar a função NmrDeregisterClient .

Um módulo cliente normalmente chama a função NmrWaitForClientDeregisterComplete de sua função Unload para aguardar até que ela seja completamente desregistrada do NMR antes que o módulo cliente seja descarregado do sistema. Um módulo cliente não deve retornar de uma chamada para sua função Unload até que o cancelamento do registro seja concluído.

Nota Se um módulo cliente usar o Windows Driver Framework, ele normalmente chamará a função NmrWaitForClientDeregisterComplete de sua função de retorno de chamada de evento EvtDriverUnload . Nessa situação, o módulo cliente não deve retornar de uma chamada para sua função EvtDriverUnload até que o cancelamento do registro seja concluído.
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho netioddk.h (inclua Wsk.h)
Biblioteca Netio.lib
IRQL < DISPATCH_LEVEL

Confira também

NmrDeregisterClient