Fonction RxCreateSrvCall (fcb.h)

Article
11/14/2023

RxCreateSrvCall génère une structure SRV_CALL et insère le nom dans la table de noms net géré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 Nom.

RxConnectionId

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

Valeur retournée

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 directement par les pilotes de mini-redirecteur réseau. RDBSS appelle cette routine en interne lorsqu’un paquet de demande 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 d’appareil du paramètre RxContext doit être acquis en mode exclusif.

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