Fonction RxSetSrvCallDomainName (rxprocs.h)

  • Article

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 :

Code de retour Description
STATUS_INSUFFICIENT_RESOURCES
 Les ressources étaient 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 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

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête rxprocs.h (inclure Mrxfcb.h, Rxprocs.h)
IRQL <= APC_LEVEL

Voir aussi

RxCreateSrvCall

RxFinalizeSrvCall