Partager via

IAgent::Load

  • Article

[Microsoft Agent est déconseillé à partir de Windows 7 et peut ne pas être disponible 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 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 demande de chargement .

Vous pouvez charger des caractères à partir du sous-répertoire Microsoft Agent en spécifiant un chemin d’accès relatif (qui n’inclut pas de deux-points ou de barre oblique de début). Cela préfixe le chemin d’accès avec le répertoire de caractères de l’Agent (situé dans le répertoire %windows%\msagent localisé). 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 les autres caractères en même temps à partir d’une seule connexion, car le caractère par défaut peut être le même que 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 seul fichier structuré (. ACS) avec des données de caractères et des données d’animation ensemble, ou sous forme de 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, les chemins d’accès UNC). Utilisez le distinct . ACF et . Fichiers ACA lorsque vous souhaitez charger les fichiers d’animation individuellement à partir d’un site distant où ils sont accessibles à l’aide du protocole HTTP.

Pour. Les fichiers ACS, à l’aide de la méthode Load , donnent accès aux animations d’un caractère ; Une fois chargé, vous pouvez utiliser la méthode Play pour animer le personnage. Pour. Fichiers ACF, vous utilisez également 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.