RxSetSrvCallDomainName, fonction (rxprocs. h)

RxSetSrvCallDomainName est appelé par un pilote réseau mini-redirecteur 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 se terminant par zéro qui nomme le domaine auquel ce serveur appartient.

Valeur de retour

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

Code de retour Description
STATUS_INSUFFICIENT_RESOURCES
Les ressources sont insuffisantes pour terminer cette routine. La demande d’allocation de mémoire a échoué pour que la mémoire de réserve non paginée stocke le nouveau nom de domaine.

Notes

Il se peut que le nom de domaine ne soit pas 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 sera 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 à partir d’une réserve non paginée avec une balise de pool de RX_SRVCALL_PARAMS_POOLTAG. La routine RxSetSrvCallDomainName définit les membres buffer, Lengthet MaximumLength de la structure pDomainName .

Spécifications

   
Plateforme cible Bureau
En-tête rxprocs. h (inclure Mrxfcb. h, Rxprocs. h)
NIVEAU <= APC_LEVEL

Voir aussi

RxCreateSrvCall

RxFinalizeSrvCall