Función NmrWaitForClientDeregisterComplete (netioddk.h)

  • Artículo

La función NmrWaitForClientDeregisterComplete espera a que se complete la desregistración de un módulo cliente.

Sintaxis

NTSTATUS NmrWaitForClientDeregisterComplete(
  [in] HANDLE NmrClientHandle
);

Parámetros

[in] NmrClientHandle

Identificador utilizado por el NMR para representar el registro del módulo cliente. NmR devuelve este identificador al módulo cliente cuando el módulo cliente llama a la función NmrRegisterClient .

Valor devuelto

La función NmrWaitForClientDeregisterComplete devuelve uno de los siguientes códigos NTSTATUS:

Código devuelto Descripción
STATUS_SUCCESS
 NmR completó el registro del módulo cliente.
STATUS_INVALID_PARAMETER
 El módulo cliente llamó a la función NmrWaitForClientDeregisterComplete antes de llamar a la función NmrDeregisterClient o el identificador especificado en el parámetro NmrClientHandle no es un identificador de cliente válido.
Otros códigos de estado
 Se produjo un error.

Comentarios

Un módulo cliente llama a la función NmrWaitForClientDeregisterComplete para esperar a que se complete la anulación del registro del módulo cliente. Un módulo cliente llama a la función NmrWaitForClientDeregisterComplete solo después de llamar a la función NmrDeregisterClient .

Normalmente, un módulo cliente llama a la función NmrWaitForClientDeregisterComplete desde su función Unload para esperar hasta que se anule completamente el registro de NMR antes de que el módulo cliente se descargue del sistema. Un módulo cliente no debe volver de una llamada a su función Unload hasta que se complete la anulación del registro.

Nota Si un módulo cliente usa Windows Driver Framework, normalmente llamará a la función NmrWaitForClientDeregisterComplete desde su función de devolución de llamada de eventos EvtDriverUnload . En esta situación, el módulo cliente no debe volver de una llamada a su función EvtDriverUnload hasta que se complete la anulación del registro.
 

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino Escritorio
Encabezado netioddk.h (incluya Wsk.h)
Library Netio.lib
IRQL < DISPATCH_LEVEL

Consulte también

NmrDeregisterClient