NPI_CLIENT_ATTACH_PROVIDER_FN funzione di callback (netioddk.h)

Articolo
08/07/2023

La funzione di callback ClientAttachProvider di un modulo client collega il modulo client a un modulo del provider.

Sintassi

NPI_CLIENT_ATTACH_PROVIDER_FN NpiClientAttachProviderFn;

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

Parametri

[in] NmrBindingHandle

Handle usato da NMR per rappresentare l'associazione tra il modulo client e il modulo del provider.

[in] ClientContext

Puntatore al contesto di registrazione del modulo client. Il modulo client passa questo puntatore a NMR quando chiama la funzione NmrRegisterClient per registrarsi con nmR.

[in] ProviderRegistrationInstance

Puntatore a un oggetto NPI_REGISTRATION_INSTANCE struttura. Questa struttura contiene i dati di registrazione del modulo del provider.

Valore restituito

La funzione di callback ClientAttachProvider di un modulo client restituisce uno dei codici NTSTATUS seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	Il modulo client e il modulo provider sono stati collegati tra loro.
STATUS_NOINTERFACE	Il modulo client non è collegato al modulo del provider o il modulo del provider non è collegato al modulo client.
Altri codici di stato	Si è verificato un errore.

Commenti

Dopo che un modulo client è stato registrato con NMR, nmR chiama la funzione di callback ClientAttachProvider del modulo client, una volta per ogni modulo provider registrato come provider dello stesso server dei criteri di rete per cui il modulo client è registrato come client.

NmR chiama anche la funzione di callback ClientAttachProvider di un modulo client ogni volta che un nuovo modulo di rete viene registrato come provider dello stesso server dei criteri di rete per cui il modulo client è registrato come client.

Un modulo client può esaminare i dati di registrazione del modulo del provider. Questi dati si trovano nella struttura a cui punta il parametro ProviderRegistrationInstance . Il modulo client usa questi dati per determinare se verrà collegato al modulo del provider:

Se il modulo client determina che verrà collegato al modulo del provider, la funzione di callback ClientAttachProvider chiama la funzione NmrClientAttachProvider per continuare il processo di allegato. In questo caso la funzione di callback ClientAttachProvider deve restituire il codice di stato restituito dalla chiamata a Funzione NmrClientAttachProvider .
Se il modulo client determina che non verrà collegato al modulo del provider, la funzione di callback ClientAttachProvider deve restituire STATUS_NOINTERFACE.

Se il modulo client viene collegato correttamente al modulo del provider, deve salvare l'handle fornito nel parametro NmrBindingHandle . Il modulo client passa questo handle come parametro a Funzione NmrClientDetachProviderComplete quando si scollega dal modulo del provider.

NmR chiama la funzione di callback ClientAttachProvider di un modulo client in IRQL = PASSIVE_LEVEL.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione	Windows
Intestazione	netioddk.h (include Wsk.h)
IRQL	PASSIVE_LEVEL