NPI_CLIENT_DETACH_PROVIDER_FN funzione di callback (netioddk.h)
Un modulo client ClientDetachProvider funzione di callback 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 a NMR quando chiama la funzione NmrClientAttachProvider da collegare al modulo del provider.
Valore restituito
Un modulo client ClientDetachProvider funzione di callback restituisce uno dei codici NTSTATUS seguenti:
| Codice restituito | Descrizione |
|---|---|
|
Il modulo client è stato scollegato correttamente dal modulo del provider. |
|
Impossibile scollegare immediatamente il modulo client dal modulo del provider. |
Osservazioni
NmR chiama la funzione di callback client clientDetachProvider ogni volta che l'associazione tra il modulo client e un modulo provider deve essere terminata. Lo scollegamento viene avviato dal modulo client che chiama la funzione NmrDeregisterClient o il modulo provider che chiama la funzione NmrDeregisterProvider.
Dopo aver chiamato clientDetachProvider funzione di callback, un modulo client non deve effettuare altre chiamate a nessuna delle funzioni NPI del modulo del provider. Se non sono presenti chiamate in corso a una delle funzioni NPI del modulo provider quando viene chiamata la funzione di callback client ClientDetachProvider, viene chiamata la funzione di callback del modulo client ClientDetachProvider funzione di callback restituisce STATUS_SUCCESS.
Se sono in corso chiamate a uno o più dei npi del modulo provider funzioni quando viene chiamata la funzione di callback del modulo client ClientDetachProvider, viene chiamata la funzione di callback del modulo client ClientDetachProvider funzione di callback restituisce STATUS_PENDING. In questo caso, il modulo client deve chiamare funzione NmrClientDetachProviderComplete dopo il completamento di tutte le chiamate in corso alle funzioni NPI del modulo del provider. Chiamata all'oggetto funzione NmrClientDetachProviderComplete notifica al NMR che lo scollegamento dal modulo del provider è stato completato.
NmR chiama il modulo client ClientCleanupBindingContext funzione di callback e del modulo del provider ProviderCleanupBindingContext funzione di callback dopo che sia il modulo client che il modulo provider hanno completato lo scollegamento tra loro.
NmR chiama la funzione di callback client ClientDetachProvider in qualsiasi <IRQL = DISPATCH_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 | <= DISPATCH_LEVEL |