Funzione NmrRegisterClient (netioddk.h)
La funzione nmrRegisterClient registra un modulo client con NMR.
Sintassi
NTSTATUS NmrRegisterClient(
[in] PNPI_CLIENT_CHARACTERISTICS ClientCharacteristics,
[in] __drv_aliasesMem PVOID ClientContext,
[out] PHANDLE NmrClientHandle
);
Parametri
[in] ClientCharacteristics
Puntatore a un oggetto NPI_CLIENT_CHARACTERISTICS struttura che descrive le caratteristiche del modulo client. Il modulo client deve assicurarsi che questa struttura rimanga valida e residente in memoria, purché il modulo client sia registrato con NMR.
[in] ClientContext
Puntatore a un contesto fornito dal chiamante per la registrazione. Il modulo client usa questo contesto per tenere traccia dello stato della registrazione client. Il contenuto del contesto di registrazione del modulo client è opaco per nmR. NmR passa questo puntatore al modulo client ogni volta che chiama la funzione di callback del modulo client ClientAttach Provider. Il modulo client deve assicurarsi che il contesto di registrazione rimanga valido e residente in memoria, purché il modulo client sia registrato con NMR.
[out] NmrClientHandle
Puntatore a una variabile che riceve un handle usato da NMR per rappresentare la registrazione del modulo client. Il modulo client deve salvare questo handle e passarlo come parametro alla funzione NmrDeregisterClient quando annulla la registrazione dall'NMR.
Valore restituito
La funzione nmrRegisterClient restituisce uno dei codici NTSTATUS seguenti:
| Codice restituito | Descrizione |
|---|---|
|
NmR ha registrato correttamente il modulo client. |
|
NmR non dispone di risorse di sistema sufficienti per registrare il modulo client. |
|
Si è verificato un errore. |
Osservazioni
Un modulo client chiama la funzione NmrRegisterClient per la registrazione come client di un NPI in modo che possa collegarsi ai moduli del provider che si registrano come provider dello stesso server dei criteri di rete.
Un modulo client chiama in genere la funzione NmrRegisterClient dalla funzione DriverEntry dopo aver completato tutte le altre attività di inizializzazione. La chiamata al NmrRegisterClient funzione indica al NMR che il modulo client è pronto per il collegamento a tutti i moduli del provider registrati o registrati come provider della stessa NPI per cui il modulo client è registrato come client.
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 | PASSIVE_LEVEL |