NPI_PROVIDER_DETACH_CLIENT_FN funzione di callback (netioddk.h)
La funzione di callback ProviderDetachClient del modulo provider scollega il modulo provider da un modulo client.
Sintassi
NPI_PROVIDER_DETACH_CLIENT_FN NpiProviderDetachClientFn;
NTSTATUS NpiProviderDetachClientFn(
[in] PVOID ProviderBindingContext
)
{...}
Parametri
[in] ProviderBindingContext
Puntatore al contesto del modulo del provider per l'associazione tra il modulo provider e il modulo client da cui si sta scollegando. La funzione di callback provider del modulo ProviderAttachClient restituisce questo puntatore al nmR quando si collega al modulo client.
Valore restituito
La funzione di callback ProviderDetachClient del modulo provider restituisce uno dei codici NTSTATUS seguenti:
Codice restituito | Descrizione |
---|---|
|
Il modulo provider è stato scollegato correttamente dal modulo client. |
|
Impossibile scollegare immediatamente il modulo del provider dal modulo client. |
Commenti
NmR chiama la funzione di callback provider del modulo ProviderDetachClient ogni volta che l'associazione tra il modulo provider e un modulo client 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 ProviderDetachClient , un modulo provider non deve effettuare più chiamate a una delle funzioni di callback del modulo client. Se non sono presenti chiamate in corso a una delle funzioni di callback del modulo client quando viene chiamata la funzione di callback provider del modulo provider, viene chiamata la funzione di callback ProviderDetachClient del modulo del provider, la funzione di callback del modulo provider restituisce STATUS_SUCCESS.
Se sono presenti chiamate in corso a una o più delle funzioni di callback del modulo client del modulo client quando viene chiamata la funzione di callback provider del modulo provider, la funzione di callback ProviderDetachClient del modulo provider restituisce STATUS_PENDING. In questa situazione, il modulo del provider deve chiamare Funzione NmrProviderDetachClientComplete dopo aver completato tutte le chiamate in corso alle funzioni di callback del modulo client. Chiamata all'oggetto La funzione NmrProviderDetachClientComplete notifica al nmR che il scollegamento dal modulo client è stato completato.
NmR chiama il modulo clientFunzione di callback clientCleanupBindingContext e del modulo del providerLa funzione di callback providerCleanupBindingContext dopo che sia il modulo client che il modulo provider hanno completato lo scollegamento tra loro.
NmR chiama la funzione di callback provider del modulo ProviderDetachClient 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 |