Función NmrDeregisterClient (netioddk.h)

Artículo
08/07/2023

La función NmrDeregisterClient anula el registro de un módulo de 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 de 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	NmR inició la desregistración del módulo de cliente. El módulo cliente debe llamar al La función NmrWaitForClientDeregisterComplete esperará hasta que se complete la desregistración antes de que se pueda descargar el módulo cliente.
Otros códigos de estado	Se produjo un error.

Comentarios

Cuando un módulo cliente llama a la función NmrDeregisterClient , NMR llama a la función de devolución de llamada ClientDetachProvider del módulo cliente y a la función de devolución de llamada ProviderDetachClient del módulo de proveedor para cada uno de los enlaces entre el módulo cliente y un módulo de proveedor. La anulación del registro del módulo cliente de NMR se completa después de que el módulo de 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 hayan desasociado correctamente del módulo cliente.

Normalmente, un módulo cliente llama a la función NmrDeregisterClient desde su función Unload para desasociarse 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 , un módulo cliente debe llamar a . Función 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 volver de 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 eventos EvtDriverUnload . En esta situación, el módulo cliente no debe volver de una llamada a su función EvtDriverUnload hasta después de completarse la desregistración.

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