Funzione RxCreateVNetRoot (fcb.h)

Articolo
02/26/2024

RxCreateVNetRoot alloca e inizializza una struttura NET_ROOT e inserisce il nome nella tabella dei nomi net nell'oggetto dispositivo associato.

Sintassi

PV_NET_ROOT RxCreateVNetRoot(
  [in] IN PRX_CONTEXT       RxContext,
  [in] IN PNET_ROOT         NetRoot,
  [in] IN PUNICODE_STRING   CanonicalName,
  [in] IN PUNICODE_STRING   LocalNetRootName,
  [in] IN PUNICODE_STRING   FilePath,
  [in] IN PRX_CONNECTION_ID RxConnectionId
);

Parametri

[in] RxContext

Puntatore alla RX_CONTEXT RDBSS contenente l'IRP che descrive un'operazione di creazione.

[in] NetRoot

Puntatore alla struttura di NET_ROOT associata.

[in] CanonicalName

Puntatore al nome canonico da inserire nella tabella dei nomi.

[in] LocalNetRootName

Puntatore al nome del NET_ROOT locale senza il nome del prefisso.

[in] FilePath

Puntatore a un nome percorso file. Questo parametro non è attualmente usato e può essere NULL.

[in] RxConnectionId

Puntatore all'ID di connessione da associare al nome da inserire nella tabella dei nomi del prefisso. Questo parametro può essere NULL nel qual caso non verrà associato alcun ID di connessione al nome inserito nella tabella dei nomi.

Valore restituito

RxCreateVNetRoot restituisce un puntatore a una struttura di dati appena creata V_NET_ROOT in caso di esito positivo o di un puntatore NULL in caso di errore.

Commenti

La routine RxCreateVNetRoot non viene normalmente chiamata dai driver mini-reindirizzamento di rete direttamente. RDBSS chiama questa routine internamente quando viene ricevuto un pacchetto di richiesta di I/O per IRP_MJ_CREATE e deve essere creato un V_NET_ROOT. Questo servizio IRP viene normalmente ricevuto da RDBSS in risposta a un'applicazione in modalità utente che richiede un'operazione di creazione di file in una condivisione di rete. È anche possibile che un altro driver del kernel esecchi tale IRP.

Prima di chiamare RxCreateVNetRoot, è necessario acquisire un blocco nella tabella dei nomi associata al membro dell'oggetto dispositivo del parametro RxContext in modalità esclusiva.

RxCreateVNetRoot imposta un'ampia gamma di parametri di contesto di sicurezza nella struttura V_NET_ROOT in base ai parametri della RX_CONTEXT. Questi parametri includono quanto segue: LogonId, SessionId, pUserName, pUserDomainName, pPassword e Flags.