RxCreateSrvCall, fonction (fcb.h)

Article
02/06/2025

RxCreateSrvCall génère une structure SRV_CALL et insère le nom dans la table de noms net conservée par RDBSS.

Syntaxe

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

Paramètres

RxContext

[in] Pointeur vers la structure RX_CONTEXT contenant l’IRP décrivant une opération de création.

Name

[in] Pointeur vers le nom à insérer dans la table de noms.

InnerNamePrefix

Pointeur vers un nom de préfixe interne facultatif à insérer dans la table de noms avec le Name.

RxConnectionId

[in] Pointeur vers l’ID de connexion à associer au nom à insérer dans la table de noms de préfixe. Ce paramètre peut être null auquel cas aucun ID de connexion n’est associé au nom inséré dans la table de noms de préfixe.

Valeur de retour

RxCreateSrvCall retourne un pointeur vers une structure de données SRV_CALL nouvellement créée en cas de réussite ou un pointeur NULL en cas d’échec.

Remarques

La routine RxCreateSrvCall n’est normalement pas appelée par les pilotes de mini-redirecteur réseau directement. RDBSS appelle cette routine en interne lorsqu’un paquet de requête d’E/S est reçu pour IRP_MJ_CREATE et qu’un SRV_CALL doit être créé. Cette IRP est normalement reçue par RDBSS en réponse à une application en mode utilisateur demandant une opération de création de fichier sur un partage réseau. Il est également possible pour un autre pilote de noyau d’émettre un tel IRP.

Avant d’appeler RxCreateSrvCall, un verrou sur la table de noms associée au membre de l’objet appareil du paramètre RxContext doit être acquis en mode exclusif.

RxCreateSrvCall initialise les paramètres d’appel du serveur transmis via des attributs étendus dans le cadre de la structure RX_CONTEXT associée. Actuellement, cela inclut l’initialisation du pPrincipalName membre du SRV_CALL passé par le pilote DFS.