Função NmrDeregisterClient (netioddk.h)

Artigo
02/29/2024

A função NmrDeregisterClient desregistra um módulo cliente do NMR.

Sintaxe

NTSTATUS NmrDeregisterClient(
  [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 NmrDeregisterClient retorna um dos seguintes códigos NTSTATUS:

Código de retorno	Descrição
STATUS_PENDING	O NMR iniciou o cancelamento do registro do módulo cliente. O módulo cliente deve chamar o Função NmrWaitForClientDeregisterComplete para aguardar até que a desregistração seja concluída antes que o módulo cliente possa ser descarregado.
Outros códigos status	Ocorreu um erro.

Comentários

Quando um módulo cliente chama a função NmrDeregisterClient , a NMR chama a função de retorno de chamada ClientDetachProvider do módulo cliente e a função de retorno de chamada ProviderDetachClient do módulo do provedor para cada uma das associações entre o módulo cliente e um módulo do provedor. A desregistração do módulo cliente do NMR é concluída depois que o módulo cliente é desanexado com êxito de todos os módulos do provedor aos quais ele está anexado e todos esses módulos do provedor foram desanexados com êxito do módulo cliente.

Um módulo cliente normalmente chama a função NmrDeregisterClient de sua função Unload para desanexar-se de todos os módulos do provedor aos quais ele é anexado antes que o módulo cliente seja descarregado do sistema. Depois de chamar a função NmrDeregisterClient , um módulo cliente deve chamar o Função NmrWaitForClientDeregisterComplete para aguardar a conclusão do cancelamento do registro antes que o módulo cliente possa ser descarregado. 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 NmrDeregisterClient 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