Funzione RxCreateSrvCall (fcb.h)

Articolo
02/06/2025

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

Sintassi

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

Parametri

RxContext

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

Name

[in] Puntatore al nome da inserire nella tabella dei nomi.

InnerNamePrefix

Puntatore a un nome di prefisso interno facoltativo da inserire nella tabella dei nomi con il nome Nome.

RxConnectionId

[in] Puntatore all'ID 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 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 NULL in caso di errore.

Osservazioni

La routine RxCreateSrvCall non viene normalmente chiamata direttamente dai driver del mini-reindirizzamento 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 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 kernel rilasci tale IRP.

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

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