Compartir a través de


Función NmrDeregisterClient (netioddk.h)

La función NmrDeregisterClient registra un módulo cliente de NMR.

Sintaxis

NTSTATUS NmrDeregisterClient(
  [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 NmrDeregisterClient devuelve uno de los siguientes códigos NTSTATUS:

Código devuelto Descripción
STATUS_PENDING
El NMR inició la desregistración del módulo cliente. El módulo cliente debe llamar al función de NmrWaitForClientDeregisterComplete para esperar hasta que se complete la desregistración antes de que se pueda descargar el módulo cliente.
otros códigos de estado
Error.

Observaciones

Cuando un módulo cliente llama a la función de NmrDeregisterClient, el NMR llama a la función de devolución de llamada del módulo cliente ClientDetachProvider y la función de devolución de llamada del módulo de proveedor ProviderDetachClient función de devolución de llamada para cada uno de los enlaces entre el módulo cliente y un módulo de proveedor. El registro del módulo cliente del NMR se completa después de que el módulo cliente se haya desasociado correctamente de todos los módulos de proveedor a los que está asociado y todos esos módulos de proveedor se han desasociado correctamente del módulo cliente.

Normalmente, un módulo cliente llama a la función NmrDeregisterClient desde su función Unload para separarse de todos los módulos de proveedor a los que está asociado antes de que el módulo cliente se descargue del sistema. Después de llamar a la función nmrDeregisterClient de, un módulo cliente debe llamar a . función de NmrWaitForClientDeregisterComplete para esperar a que se complete la desregistración antes de que se pueda descargar el módulo cliente. Un módulo cliente no debe devolver desde una llamada a su función Unload hasta que se complete la desregistración.

Nota Si un módulo cliente usa Windows Driver Framework, normalmente llamará a la función NmrDeregisterClient desde su función de devolución de llamada de evento EvtDriverUnload. En esta situación, el módulo cliente no debe devolver desde una llamada a su función EvtDriverUnload hasta que se complete la desregistración.
 

Requisitos

Requisito Valor
cliente mínimo admitido Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
de la plataforma de destino de Escritorio
encabezado de netioddk.h (incluya Wsk.h)
biblioteca de Netio.lib
irQL <= DISPATCH_LEVEL

Consulte también

ClientDetachProvider

EvtDriverUnload

NmrRegisterClient

NmrWaitForClientDeregisterComplete

ProviderDetachClient

descargar