IAgentCharacter::SetName

[Der Microsoft-Agent ist ab Windows 7 veraltet und kann in nachfolgenden Versionen von Windows nicht verfügbar sein.]

HRESULT SetName(
   BSTR bszName   // character name
);

Legt den Namen des Zeichens fest.

• Gibt S_OK zurück, um anzugeben, dass der Vorgang erfolgreich war.

bszName

Ein BSTR, der den Namen des Zeichens festlegt. Der Standardname eines Zeichens wird definiert, wenn es mit dem Microsoft Agent Character Editor kompiliert wird. Sie können sie mit IAgentCharacter::SetNameändern; Dadurch wird jedoch der Zeichenname für alle aktuellen Clients des Zeichens geändert. Diese Eigenschaft ist nicht dauerhaft (dauerhaft gespeichert). Der Name des Zeichens wird auf den Standardnamen zurückgesetzt, wenn das Zeichen zuerst von einem Client geladen wird.

Der Name des Zeichens hängt möglicherweise auch von seiner Sprach-ID ab. Zeichen können mit unterschiedlichen Namen für verschiedene Sprachen kompiliert werden.

Der Server verwendet die Namenseinstellung des Zeichens in Teilen der Benutzeroberfläche von Microsoft Agent, z. B. den Titel des Sprachbefehlsfensters, wenn das Zeichen eingabeaktiv ist, und im Popupmenü der Microsoft Agent-Taskleiste.

Siehe auch

IAgentCharacter::GetName