IAgentCharacterEx::GetActive

[Der Microsoft Agent ist seit Windows 7 veraltet und kann in späteren Versionen von Windows nicht mehr verfügbar sein.]

HRESULT GetActive(
   short * psState  // address of active state setting
);

Ruft ab, ob Ihre Clientanwendung der aktive Client des Charakters ist und ob der Charakter der oberste ist.

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

psState

Adresse einer Variablen, die einen der folgenden Werte für die Zustandseinstellung empfängt:

Wert	Beschreibung
const unsigned shortACTIVATE_NOTACTIVE = 0;	Ihr Client ist nicht der aktive Client des Charakters.
const unsigned shortACTIVATE_ACTIVE = 1;	Ihr Client ist der aktive Client des Charakters.
const unsigned shortACTIVATE_INPUTACTIVE = 2;	Ihr Client ist eingabeaktiv (aktiver Client des obersten Charakters).

Mit dieser Einstellung können Sie feststellen, ob Sie der aktive Client des Charakters sind oder ob Ihr Charakter der eingabeaktive Charakter ist. Wenn mehrere Clientanwendungen denselben Charakter gemeinsam nutzen, empfängt der aktive Client des Charakters die Mauseingabe (z. B. Klick- oder Ziehereignisse der Microsoft Agent-Steuerung). Ebenso erhält bei der Anzeige mehrerer Charaktere der aktive Client des obersten Charakters (auch eingabeaktiver Client genannt) IAgentNotifySink::Command-Ereignisse.

Verwenden Sie die Activate-Methode, um festzulegen, ob Ihre Anwendung der aktive Client des Charakters ist oder um Ihre Anwendung zum eingabeaktiven Client zu machen (wodurch der Charakter zum obersten Charakter wird).

Weitere Informationen

IAgentCharacter::Activate, IAgentNotifySinkEx::ActiveClientChange