Fonction RxSetSrvCallDomainName (rxprocs.h)

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 retournée

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

Remarques

Le nom de domaine peut ne pas être connu au début d’une demande de redirecteur réseau. La routine RxSetSrvCallDomainName permet d’associer le nom de domaine à SrvCall une fois qu’il est connu. Cette routine est 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 est 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 à partir d’un pool non paginé avec une balise de pool de RX_SRVCALL_PARAMS_POOLTAG. La routine RxSetSrvCallDomainName définit les membres buffer, length et MaximumLength de la structure pDomainName .

Configuration requise

Voir aussi

RxCreateSrvCall

RxFinalizeSrvCall