Função NmrDeregisterClient (netioddk.h)

A função NmrDeregisterClient desregistros de 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.

Valor de retorno

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 aguardar até que a desregistração seja concluída antes que o módulo cliente possa ser descarregado.
Outros códigos de status	Ocorreu um erro.

Observações

Quando um módulo cliente chama a função NmrDeregisterClient, o NMR chama a função de retorno de chamada ClientDetachProvider do módulo cliente e o providerDetachClient do módulo do provedor função de retorno de chamada para cada uma das associações entre o módulo cliente e um módulo de provedor. O cancelamento do registro do módulo cliente da NMR é concluído 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 de provedor foram desanexados com êxito do módulo cliente.

Um módulo cliente normalmente chama a função NmrDeregisterClient de sua função Descarregar para se desanexar 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 aguardar a conclusão 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 Descarregar até que o cancelamento do registro seja concluído.

Observação 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
de cliente com suporte mínimo	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
da Plataforma de Destino	Área de trabalho
cabeçalho	netioddk.h (inclua Wsk.h)
biblioteca	Netio.lib
IRQL	<= DISPATCH_LEVEL

Consulte também

ClientDetachProvider

EvtDriverUnload

NmrRegisterClient

NmrWaitForClientDeregisterComplete

ProviderDetachClient

descarregar