NPI_CLIENT_ATTACH_PROVIDER_FN funzione di callback (netioddk.h)

Articolo
02/07/2025

Un modulo client ClientAttachProvider funzione di callback collega il modulo client a un modulo 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 al 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

Un modulo client ClientAttachProvider funzione di callback 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 è stato collegato al modulo del provider o il modulo del provider non è stato collegato al modulo client.
Altri codici di stato	Si è verificato un errore.

Osservazioni

Dopo aver registrato un modulo client con NMR, nmR chiama la funzione di callback client ClientAttachProvider funzione di callback, una volta per ogni modulo del provider registrato come provider dello stesso NPI per cui il modulo client è registrato come client.

NmR chiama anche clientAttachProvider funzione di callback ogni volta che un nuovo modulo di rete viene registrato come provider dello stesso NPI 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 ClientAttachProvider callback chiama la funzione di callback 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 di 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 disconnette dal modulo del provider.

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

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
piattaforma di destinazione	Finestre
intestazione	netioddk.h (include Wsk.h)
IRQL	PASSIVE_LEVEL