Funzione RxCreateNetFcb (fcb.h)

Articolo
02/26/2024

RxCreateNetFCB alloca, inizializza e inserisce una nuova struttura FCB nelle strutture di dati in memoria per un V_NET_ROOT in cui viene aperto questo fcB. La struttura allocata ha spazio per un SRV_OPEN e una struttura FOBX.

Sintassi

PFCB RxCreateNetFcb(
  [in] IN PRX_CONTEXT     RxContext,
  [in] IN PIRP            Irp,
  [in] IN PV_NET_ROOT     VNetRoot,
  [in] IN PUNICODE_STRING Name
);

Parametri

[in] RxContext

Puntatore alla struttura RX_CONTEXT che descrive un'operazione di creazione.

[in] Irp

Puntatore alla struttura IRP incapsulata da questa struttura RX_CONTEXT.

[in] VNetRoot

Puntatore alla struttura V_NET_ROOT in cui viene aperto questo fcB.

[in] Name

Nome del fcB. Il V_NET_ROOT può contenere un prefisso di nome che deve essere preceduto qui.

Valore restituito

RxCreateNetFCB restituisce un puntatore a una struttura di dati FCB appena allocata in caso di esito positivo o un puntatore NULL in caso di errore.

Commenti

La routine RxCreateNetFCB non viene normalmente chiamata dai driver di 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 creata una struttura FCB. 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.

Se l'fcB da creare è un file di paging, RxCreateNetFCB alloca memoria del pool non a pagina quando si crea la nuova struttura dati FCB e imposta il flag seguente nel membro FcbState del fcb:

Se l'fcB da creare non è un file di paging, RxCreateNetFCB alloca la memoria del pool impaginata durante la creazione della nuova struttura di dati FCB.

Windows non consente attualmente di avere un file di paging in un computer remoto.

Se il membro Create.Flags nell'RX_CONTEXT ha il flag di RX_CONTEXT_CREATE_FLAG_ADDEDBACKSLASH, il membro FcbState del fcbState del cluster di sicurezza di azure ha il flag FCB_STATE_ADDEDBACKSLASH impostato su.