RxSetSrvCallDomainName, fonction (rxprocs.h)

Article
02/07/2025

RxSetSrvCallDomainName est appelé par un pilote de mini-redirecteur réseau pour définir le nom de domaine associé à un serveur donné (structure SRV_CALL).

Syntaxe

NTSTATUS RxSetSrvCallDomainName(
  [in] IN PMRX_SRV_CALL   SrvCall,
  [in] IN PUNICODE_STRING DomainName
);

Paramètres

[in] SrvCall

Pointeur vers la structure SRV_CALL.

[in] DomainName

Pointeur vers une mémoire tampon contenant une chaîne Unicode sans fin qui nomme le domaine auquel appartient ce serveur.

Valeur de retour

RxSetSrvCallDomainName retourne STATUS_SUCCESS en cas de réussite ou l’une des valeurs d’erreur suivantes en cas d’échec :

Retourner le code	Description
STATUS_INSUFFICIENT_RESOURCES	Il y avait des ressources insuffisantes pour effectuer cette routine. La demande d’allocation de mémoire a échoué pour que la mémoire du pool non paginé stocke le nouveau nom de domaine.

Remarques

Le nom de domaine peut ne pas être connu au début d’une demande de redirecteur réseau. La routine RxSetSrvCallDomainName permet au nom de domaine d’être associé à SrvCall une fois qu’il est connu. Cette routine serait normalement utilisée dans le cadre de la création et de l’initialisation d’une structure SRV_CALL.

Si un nom de domaine est déjà associé au paramètre SrvCall, ce nom de domaine est supprimé et la mémoire associée à cette entrée dans SrvCall sera libérée.

Si le paramètre DomainName n’est pas un pointeur NULL et que le paramètre DomainName a une longueur supérieure à zéro, RxSetSrvCallDomainName alloue de l’espace pour le membre pDomainName de SrvCall du pool non paginé avec une balise de pool de RX_SRVCALL_PARAMS_POOLTAG. La routine RxSetSrvCallDomainName définit les de mémoire tampon, longueuret membres maximumLength de la structure pDomainName.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	rxprocs.h (include Mrxfcb.h, Rxprocs.h)
IRQL	<= APC_LEVEL

Voir aussi

RxCreateSrvCall

RxFinalizeSrvCall

Partager via