Funzione RxCreateSrvCall (fcb.h)

Articolo
08/13/2022
2 minuti per la lettura

RxCreateSrvCall compila una struttura SRV_CALL e inserisce il nome nella tabella net name gestita da RDBSS.

Sintassi

PSRV_CALL RxCreateSrvCall(
  [in] IN PRX_CONTEXT       RxContext,
  [in] IN PUNICODE_STRING   Name,
       IN PUNICODE_STRING   InnerNamePrefix,
  [in] IN PRX_CONNECTION_ID RxConnectionId
);

Parametri

[in] RxContext

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

[in] Name

Puntatore al nome da inserire nella tabella dei nomi.

InnerNamePrefix

[in] RxConnectionId

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

Valore restituito

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

Commenti

La routine RxCreateSrvCall 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 SRV_CALL. Questo protocollo IRP viene in genere 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 eseeva tale IRP.

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

RxCreateSrvCall inizializza i parametri di chiamata del server passati tramite attributi estesi come parte della struttura di RX_CONTEXT associata. Questo include attualmente l'inizializzazione del membro pPrincipalName del SRV_CALL passato dal driver DFS.