NPI_CLIENT_DETACH_PROVIDER_FN funzione di callback (netioddk.h)

Articolo
02/27/2024

La funzione di callback ClientDetachProvider del modulo client scollega il modulo client da un modulo provider.

Sintassi

NPI_CLIENT_DETACH_PROVIDER_FN NpiClientDetachProviderFn;

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

Parametri

[in] ClientBindingContext

Puntatore al contesto del modulo client per l'associazione tra il modulo client e il modulo provider da cui si sta scollegando. Il modulo client passa questo puntatore al nmR quando chiama la funzione NmrClientAttachProvider per collegarsi al modulo del provider.

Valore restituito

La funzione di callback ClientDetachProvider del modulo client restituisce uno dei codici NTSTATUS seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	Il modulo client è stato scollegato correttamente dal modulo provider.
STATUS_PENDING	Impossibile scollegare immediatamente il modulo client dal modulo provider.

Commenti

NmR chiama la funzione di callback client del modulo clientDetachProvider ogni volta che l'associazione tra il modulo client e un modulo provider deve essere terminata. Il scollegamento viene avviato dal modulo client che chiama la funzione NmrDeregisterClient o il modulo provider che chiama la funzione NmrDeregisterProvider .

Dopo aver chiamato la funzione di callback ClientDetachProvider , un modulo client non deve effettuare più chiamate a una delle funzioni NPI del modulo del provider. Se non sono presenti chiamate in corso a una delle funzioni NPI del modulo del provider quando viene chiamata la funzione di callback client del modulo client ClientDetachProvider, la funzione di callback client del modulo client restituisce STATUS_SUCCESS.

Se sono presenti chiamate in corso a una o più delle funzioni NPI del modulo del provider quando viene chiamata la funzione di callback client del modulo client, viene chiamata la funzione di callback client del modulo client, la funzione di callback clientDetachProvider restituisce STATUS_PENDING. In questa situazione, il modulo client deve chiamare Funzione NmrClientDetachProviderComplete dopo aver completato tutte le chiamate in corso alle funzioni NPI del modulo del provider. Chiamata all'oggetto La funzione NmrClientDetachProviderComplete notifica al nmR che il scollegamento dal modulo provider è stato completato.

NmR chiama il modulo clientFunzione di callback clientCleanupBindingContext e del modulo del providerLa funzione di callback providerCleanupBindingContext dopo il modulo client e il modulo provider hanno completato il scollegamento tra loro.

NmR chiama la funzione di callback clientDetachProvider di un modulo client in qualsiasi irQL <= DISPATCH_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	<= DISPATCH_LEVEL