Funzione NmrDeregisterClient (netioddk.h)

Articolo
02/07/2025

La funzione NmrDeregisterClient annulla la registrazione di un modulo client da NMR.

Sintassi

NTSTATUS NmrDeregisterClient(
  [in] HANDLE NmrClientHandle
);

Parametri

[in] NmrClientHandle

Handle usato da NMR per rappresentare la registrazione del modulo client. NmR restituisce questo handle al modulo client quando il modulo client chiama la funzione NmrRegisterClient.

Valore restituito

La funzione nmrDeregisterClient restituisce uno dei codici NTSTATUS seguenti:

Codice restituito	Descrizione
STATUS_PENDING	NmR ha avviato la registrazione del modulo client. Il modulo client deve chiamare il funzione di NmrWaitForClientDeregisterComplete per attendere il completamento della registrazione prima che il modulo client possa essere scaricato.
Altri codici di stato	Si è verificato un errore.

Osservazioni

Quando un modulo client chiama la funzione nmrDeregisterClient, il nmr chiama la funzione di callback del modulo client ClientDetachProvider funzione di callback e la funzione di callback del modulo del provider ProviderDetachClient funzione di callback per ognuna delle associazioni tra il modulo client e un modulo provider. La registrazione del modulo client da NMR viene completata dopo che il modulo client è stato scollegato correttamente da tutti i moduli del provider a cui è collegato e tutti i moduli del provider sono stati scollegati correttamente dal modulo client.

Un modulo client chiama in genere la funzione NmrDeregisterClient dalla funzione Scarica per scollegarsi da tutti i moduli del provider a cui è collegato prima che il modulo client venga scaricato dal sistema. Dopo aver chiamato la funzione nmrDeregisterClient, un modulo client deve chiamare il funzione di NmrWaitForClientDeregisterComplete per attendere il completamento della registrazione prima che il modulo client possa essere scaricato. Un modulo client non deve restituire da una chiamata alla relativa funzione Scarica fino al completamento della registrazione.

Nota Se un modulo client usa Windows Driver Framework, in genere chiamerà la funzione NmrDeregisterClient dal relativo EvtDriverUnload funzione di callback degli eventi. In questo caso, il modulo client non deve restituire da una chiamata alla relativa funzione EvtDriverUnload fino al completamento della registrazione.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
piattaforma di destinazione	Desktop
intestazione	netioddk.h (include Wsk.h)
libreria	Netio.lib
IRQL	<= DISPATCH_LEVEL