Função NmrWaitForProviderDeregisterComplete (netioddk.h)

  • Artigo

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

Sintaxe

NTSTATUS NmrWaitForProviderDeregisterComplete(
  [in] HANDLE NmrProviderHandle
);

Parâmetros

[in] NmrProviderHandle

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

Retornar valor

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

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

Comentários

Um módulo de provedor chama a função NmrWaitForProviderDeregisterComplete para aguardar a conclusão do cancelamento do registro do módulo do provedor. Um módulo de provedor chama a função NmrWaitForProviderDeregisterComplete somente depois de chamar a função NmrDeregisterProvider .

Um módulo de provedor normalmente chama a função NmrWaitForProviderDeregisterComplete de sua função Unload para aguardar até que ela seja completamente desregistrado do NMR antes que o módulo do provedor seja descarregado do sistema. Um módulo de provedor 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 de provedor usar a Estrutura do Driver do Windows, ele normalmente chamará o Função NmrWaitForProviderDeregisterComplete de sua função de retorno de chamada de evento EvtDriverUnload . Nessa situação, o módulo do provedor 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

NmrDeregisterProvider