Funzione RxCreateNetRoot (fcb.h)

Articolo
02/26/2024

RxCreateNetRoot alloca e inizializza una struttura NET_ROOT e inserisce il nome nella tabella net name nell'oggetto dispositivo associato.

Sintassi

PNET_ROOT RxCreateNetRoot(
  [in]           IN PSRV_CALL         SrvCall,
  [in]           IN PUNICODE_STRING   Name,
  [in]           IN ULONG             NetRootFlags,
  [in, optional] IN PRX_CONNECTION_ID RxConnectionId
);

Parametri

[in] SrvCall

Puntatore alla struttura di SRV_CALL associata.

[in] Name

Puntatore al nome da inserire nella tabella dei nomi.

[in] NetRootFlags

Valore per impostare il membro Flag dell'NET_ROOT utilizzato per indicare lo stato della struttura NET_ROOT.

[in, optional] RxConnectionId

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

Valore restituito

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

Commenti

La routine RxCreateNetRoot non viene in genere chiamata direttamente dai driver mini-redirector di rete. RDBSS chiama questa routine internamente quando viene ricevuto un pacchetto di richiesta di I/O per IRP_MJ_CREATE e deve essere creato un 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 RxCreateNetRoot, è necessario acquisire un blocco nella tabella dei nomi associata al membro dell'oggetto dispositivo del parametro SrvCall in modalità esclusiva.

I flag di NET_ROOT sono suddivisi in due gruppi, quelli visibili ai mini reindirizzamenti di rete e quelli invisibili ai mini reindirizzamenti di rete. Quelli visibili sono i 16 bit inferiori del membro Flags del NET_ROOT. Questa routine non controlla o verifica i flag impostati.

In caso di esito positivo, il conteggio dei riferimenti per la struttura SRV_CALL viene incrementato.