IAgentCharacterEx::GetLanguageID

[Microsoft Agent ist ab Windows 7 veraltet und in nachfolgenden Versionen von Windows möglicherweise nicht verfügbar.]

HRESULT GetLanguageID(
   long * plangID  // address of language ID setting
);

Ruft den Sprach-ID-Satz für das Zeichen ab.

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

plangID

Adresse einer Variablen, die die Sprach-ID-Einstellung für das Zeichen empfängt.

Eine lange ganzzahlige Zahl, die die Sprach-ID für das Zeichen angibt. Die Sprach-ID (LANGID) für ein Zeichen ist ein von Windows definierter 16-Bit-Wert, der aus einer primären Sprach-ID und einer sekundären Sprach-ID besteht. Die folgenden Beispiele sind Werte für einige Sprachen. Informationen zum Ermitteln der Werte anderer Sprachen finden Sie in der Dokumentation zum Platform SDK.

Wenn Sie diese Sprach-ID nicht für das Zeichen festlegen, ist die Sprach-ID des Zeichens die aktuelle Systemsprachen-ID.

Diese Einstellung bestimmt auch die Sprache für die TTS-Ausgabe, den Wortballontext, die Befehle im Popupmenü des Zeichens und die Spracherkennungs-Engine. Um zu ermitteln, ob eine kompatible Spracherkennungs-Engine für die Sprache des Zeichens verfügbar ist, verwenden Sie IAgentCharacterEx::GetSRModeID oder IAgentCharacterEx::GetTTSModeID.

Diese Eigenschaft gilt nur für die Verwendung des Zeichens durch Ihre Clientanwendung. Die Einstellung wirkt sich nicht auf andere Clients des Zeichens oder andere Zeichen Ihrer Clientanwendung aus.

Weitere Informationen

IAgentCharacterEx:SetLanguageID, IAgentCharacterEx::GetSRModeID, IAgentCharacterEx::GetTTSModeID