NPI_CLIENT_DETACH_PROVIDER_FN función de devolución de llamada (netioddk.h)

Artículo
08/07/2023

La función de devolución de llamada ClientDetachProvider de un módulo cliente desasocia el módulo cliente de un módulo de proveedor.

Sintaxis

NPI_CLIENT_DETACH_PROVIDER_FN NpiClientDetachProviderFn;

NTSTATUS NpiClientDetachProviderFn(
  [in] PVOID ClientBindingContext
)
{...}

Parámetros

[in] ClientBindingContext

Puntero al contexto del módulo cliente para el enlace entre el módulo cliente y el módulo de proveedor desde el que se desasocia. El módulo cliente pasa este puntero al NMR cuando llama a la función NmrClientAttachProvider para asociarlo al módulo de proveedor.

Valor devuelto

La función de devolución de llamada ClientDetachProvider de un módulo cliente devuelve uno de los siguientes códigos NTSTATUS:

Código devuelto	Descripción
STATUS_SUCCESS	El módulo cliente se desasoció correctamente del módulo de proveedor.
STATUS_PENDING	El módulo cliente no pudo desasociar del módulo de proveedor inmediatamente.

Comentarios

NmR llama a la función de devolución de llamada ClientDetachProvider de un módulo cliente cada vez que es necesario finalizar el enlace entre el módulo cliente y un módulo de proveedor. El desapego se inicia mediante el módulo cliente que llama a la función NmrDeregisterClient o al módulo de proveedor que llama a la función NmrDeregisterProvider .

Después de llamar a su función de devolución de llamada ClientDetachProvider , un módulo cliente no debe realizar más llamadas a ninguna de las funciones NPI del módulo de proveedor. Si no hay llamadas en curso a ninguna de las funciones NPI del módulo de proveedor cuando se llama a la función de devolución de llamada ClientDetachProvider del módulo cliente, la función de devolución de llamada ClientDetachProvider del módulo cliente devuelve STATUS_SUCCESS.

Si hay llamadas en curso a una o varias de las funciones NPI del módulo de proveedor cuando se llama a la función de devolución de llamada ClientDetachProvider del módulo cliente, la función de devolución de llamada ClientDetachProvider del módulo cliente devuelve STATUS_PENDING. En esta situación, el módulo cliente debe llamar al Función NmrClientDetachProviderComplete una vez completadas todas las llamadas en curso a las funciones NPI del módulo de proveedor. La llamada a La función NmrClientDetachProviderComplete notifica al NMR que se ha completado el desprendimiento del módulo de proveedor.

NmR llama al módulo de clienteFunción de devolución de llamada ClientCleanupBindingContext y del módulo de proveedorFunción de devolución de llamada ProviderCleanupBindingContext después de que el módulo cliente y el módulo de proveedor hayan completado el desaprovisionamiento entre sí.

NmR llama a la función de devolución de llamada ClientDetachProvider de un módulo cliente en cualquier IRQL <= DISPATCH_LEVEL.

Requisitos

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