Méthode ItsPubPlugin::ResolveResource (tspubplugincom.h)

Article
08/26/2023

Fournit des informations sur la connexion au bureau virtuel personnel affecté par un utilisateur. Implémentez cette méthode si vous souhaitez fournir une implémentation personnalisée de la fonctionnalité de bureau virtuel personnel.

Sinon, cette méthode doit retourner E_NOTIMPL. Cette méthode est appelée par le service RemoteApp and Desktop Connection Management lorsque le service Broker pour les connexions Bureau à distance (Broker pour les connexions Bureau à distance) connecte un utilisateur à un bureau virtuel personnel.

Syntaxe

HRESULT ResolveResource(
  [out] DWORD         *resourceType,
  [out] wchar_t [256] resourceLocation,
  [out] wchar_t [256] endPointName,
  [in]  wchar_t       *userID,
  [in]  wchar_t       *alias
);

Paramètres

[out] resourceType

Pointeur vers une variable DWORD pour recevoir le type de ressource. Il peut s’agir de l’une des valeurs suivantes.

1

Le plug-in est destiné aux pools de bureaux virtuels.

2

Le plug-in est destiné aux bureaux virtuels personnels.

[out] resourceLocation

Nom du plug-in de ressource.

[out] endPointName

Nom du point de terminaison. Pour les bureaux virtuels personnels, spécifiez le nom du bureau affecté à l’utilisateur. Pour les pools de bureaux virtuels, spécifiez le nom du pool.

[in] userID

Pointeur vers une chaîne qui contient l’identificateur de sécurité utilisateur (SID).

[in] alias

Pointeur vers une chaîne qui contient l’alias de l’utilisateur.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Le service Broker pour les connexions Bureau à distance appelle un seul plug-in lors de la connexion d’un utilisateur à une ressource. Pour recevoir des appels, vous devez inscrire votre plug-in avant de démarrer le service Broker pour les connexions Bureau à distance, ou vous devez ajouter un paramètre « LoadBalanceInfo » au fichier .rdp que le client utilise pour se connecter. Par exemple, si votre plug-in est destiné aux bureaux virtuels personnels et s’appelle « plugin1 », vous devez ajouter la ligne suivante au fichier .rdp : « LoadBalanceInfo:s:tsv://vmresource1.2.plugin1 »

Configuration requise


Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2008 R2
Plateforme cible	Windows
En-tête	tspubplugincom.h

Voir aussi

ItsPubPlugin

Partager via