IAgent ::Load

[Microsoft Agent est déconseillé à partir de Windows 7 et peut être indisponible dans les versions ultérieures de Windows.]

HRESULT Load(
   VARIANT vLoadKey,  // data provider
   long * pdwCharID,  // address of a variable for character ID
   long * pdwReqID    // address of a variable for request ID
);

Charge un caractère dans la collection Characters.

• Retourne S_OK pour indiquer que l’opération a réussi.

vLoadKey

Type de données variant qui doit être l’un des éléments suivants :

Valeur	Description
filespec	Emplacement du fichier local du fichier de définition du caractère spécifié.
url	Adresse HTTP du fichier de définition du caractère.

 

pdwCharID

Adresse d’une variable qui reçoit l’ID du caractère.

pdwReqID

Adresse d’une variable qui reçoit l’ID de requête Load.

Vous pouvez charger des caractères à partir du sous-répertoire Microsoft Agent en spécifiant un chemin relatif (celui qui n’inclut pas de signe deux-points ou de barre oblique de début). Cela préfixe le chemin d’accès au répertoire des caractères de l’agent (situé dans le répertoire localisé %windows%\msagent). Vous pouvez également utiliser une adresse relative pour spécifier votre propre répertoire dans le répertoire Chars de l’agent.

Vous ne pouvez pas charger le même caractère (un caractère ayant le même GUID) plusieurs fois à partir d’une seule connexion. De même, vous ne pouvez pas charger le caractère par défaut et d’autres caractères en même temps à partir d’une seule connexion, car le caractère par défaut peut être identique à l’autre caractère. Toutefois, vous pouvez créer une autre connexion (à l’aide de CoCreateInstance) et charger le même caractère.

Le fournisseur de données de Microsoft Agent prend en charge le chargement des données de caractères stockées sous la forme d’un fichier structuré unique (. ACS) avec des données de caractères et des données d’animation ensemble, ou en tant que données de caractères distinctes (. ACF) et animation (. Fichiers ACA). En règle générale, utilisez la structure unique . Fichier ACS pour charger un caractère stocké sur un lecteur de disque local ou un réseau et accessible à l’aide du protocole de fichier conventionnel (par exemple, unc pathnames). Utilisez le fichier distinct . ACF et . Fichiers ACA lorsque vous souhaitez charger les fichiers d’animation individuellement à partir d’un site distant auquel ils sont accessibles à l’aide du protocole HTTP.

Pour. Les fichiers ACS, à l’aide de la méthode Load fournissent un accès aux animations d’un caractère ; une fois chargé, vous pouvez utiliser la méthode Play pour animer le caractère. Pour. Les fichiers ACF vous permettent également d’utiliser la méthode Prepare pour charger des données d’animation. La méthode Load ne prend pas en charge le téléchargement. Fichiers ACS à partir d’un site HTTP.

Le chargement d’un caractère n’affiche pas automatiquement le caractère. Utilisez d’abord la méthode Show pour rendre le caractère visible.