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

El módulo cliente ClientAttachProvider función de devolución de llamada asocia el módulo cliente a un módulo de proveedor.

Sintaxis

NPI_CLIENT_ATTACH_PROVIDER_FN NpiClientAttachProviderFn;

NTSTATUS NpiClientAttachProviderFn(
  [in] HANDLE NmrBindingHandle,
  [in] PVOID ClientContext,
  [in] PNPI_REGISTRATION_INSTANCE ProviderRegistrationInstance
)
{...}

Parámetros

[in] NmrBindingHandle

Identificador usado por el NMR para representar el enlace entre el módulo cliente y el módulo de proveedor.

[in] ClientContext

Puntero al contexto de registro del módulo cliente. El módulo cliente pasa este puntero al NMR cuando llama a la función de NmrRegisterClient para registrarse en el NMR.

[in] ProviderRegistrationInstance

Puntero a un NPI_REGISTRATION_INSTANCE estructura. Esta estructura contiene los datos de registro del módulo de proveedor.

Valor devuelto

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

Código devuelto	Descripción
STATUS_SUCCESS	El módulo cliente y el módulo de proveedor se asociaron correctamente entre sí.
STATUS_NOINTERFACE	El módulo cliente no se adjuntó al módulo de proveedor o el módulo de proveedor no se adjuntó al módulo cliente.
otros códigos de estado	Error.

Observaciones

Después de que un módulo cliente se haya registrado con nmR, el NMR llama al clientAttachProvider función de devolución de llamada, una vez para cada módulo de proveedor registrado como proveedor del mismo NPI para el que el módulo cliente se ha registrado como cliente.

NmR también llama a la función de devolución de llamada ClientAttachProvid er de un módulo de cliente cada vez que un nuevo módulo de red se registra como proveedor del mismo NPI para el que el módulo cliente se ha registrado como cliente.

Un módulo cliente puede examinar los datos de registro del módulo de proveedor. Estos datos están en la estructura a la que apunta el parámetro ProviderRegistrationInstance. El módulo cliente usa estos datos para determinar si se asociará al módulo de proveedor:

• Si el módulo cliente determina que se asociará al módulo de proveedor, la función ClientAttachProvider llama a la función de devolución de llamada NmrClientAttachProvider para continuar el proceso de datos adjuntos. En esta situación, el ClientAttachProvider función de devolución de llamada debe devolver el código de estado devuelto por la llamada a . función de NmrClientAttachProvider.
• Si el módulo cliente determina que no se asociará al módulo de proveedor, el ClientAttachProvider función de devolución de llamada debe devolver STATUS_NOINTERFACE.

Si el módulo cliente se asocia correctamente al módulo de proveedor, debe guardar el identificador proporcionado en el parámetro NmrBindingHandle. El módulo cliente pasa este identificador como un parámetro al función nmrClientDetachProviderComplete cuando se desasocia del módulo de proveedor.

NmR llama a la función de devolución de llamada ClientAttachProvider de un módulo cliente función de devolución de llamada en IRQL = PASSIVE_LEVEL.

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	Windows
encabezado de	netioddk.h (incluya Wsk.h)
irQL	PASSIVE_LEVEL

Consulte también

ClientDetachProvider

NPI_CLIENT_CHARACTERISTICS

NPI_REGISTRATION_INSTANCE

NmrClientAttachProvider

NmrClientDetachProviderComplete

NmrRegisterClient