Partager via

IAgentCharacter::SetName

  • Article

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

HRESULT SetName(
   BSTR bszName   // character name
);

Définit le nom du caractère.

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

bszName

BSTR qui définit le nom du caractère. Le nom par défaut d’un caractère est défini lorsqu’il est compilé avec l’Éditeur de caractères de l’agent Microsoft. Vous pouvez le modifier à l’aide de IAgentCharacter::SetName ; toutefois, cela modifie le nom du caractère pour tous les clients actuels du caractère. Cette propriété n’est pas persistante (stockée de façon permanente). Le nom du caractère revient à son nom par défaut chaque fois que le caractère est chargé pour la première fois par un client.

Le nom du caractère peut également dépendre de son ID de langue. Les caractères peuvent être compilés avec des noms différents pour différentes langues.

Le serveur utilise le paramètre de nom du caractère dans certaines parties de l’interface de Microsoft Agent, comme le titre de la fenêtre Commandes vocales lorsque le caractère est actif en entrée et dans le menu contextuel de la barre des tâches de Microsoft Agent.

Voir aussi

IAgentCharacter::GetName