Überwachen von Sitzungsverbindungen und Trennungen

Damit eine Dienstanwendung, z. B. eine Virtuelle Kanalserveranwendung, Sitzungsverbindungen und Trennungen überwachen kann, müssen Sie sie bei Remotedesktopdiensten registrieren. Um die Anwendung bei Remotedesktopdiensten zu registrieren, speichern Sie den Namen der virtuellen Kanalserveranwendung in der Registrierung, indem Sie einen Unterschlüssel unter dem folgenden Speicherort hinzufügen:

HKEY_LOCAL_MACHINE\System\Currentcontrolset\Steuerung\TerminalServer\Addins

Der Unterschlüssel kann einen beliebigen Namen haben. Sie muss den REG_SZ Wert Name aufweisen, der den symbolischen Namen der Anwendung enthält.

Name = AddinName

Die maximale Länge des Unterschlüssels und des Werts von Name beträgt 99 Zeichen.

Der Unterschlüssel muss außerdem über einen REG_DWORD-Wert verfügen, der den Typ der Serveranwendung angibt.

Type = AddinType

AddinType muss der folgende Wert sein.

Wert	Bedeutung
3	Anwendung im Benutzermodus, Sitzungsraum.

 

Die Registrierung der Dienstanwendung wird nur in Sitzungen wirksam, die nach der Registrierung erstellt wurden.

Für jede registrierte Dienstanwendung signalisiert Remotedesktopdienste eine Reihe von Ereignisobjekten, wenn ein Client eine Verbindung mit der Sitzung herstellt oder die Verbindung mit der Sitzung trennt. Jedes virtuelle Kanal-Plug-In muss sich selbst registrieren und die Benachrichtigungsereignisse erstellen, indem CreateEvent aufgerufen wird. Die Namen dieser Ereignisobjekte entsprechen dem folgenden Format.

AddinName-Reconnect

AddinName-Disconnect

AddinName ist die Zeichenfolge, die im Wert Name des Registrierungsunterschlüssels angegeben ist, unter dem die Serveranwendung registriert ist. Durch das Erstellen dieser Ereignisse unter einer Sitzung werden sie in einem speziellen Ereignisverzeichnis pro Sitzung erstellt. Das Ereignisverzeichnis bietet zusätzliche Sicherheit, da Anwendungen in anderen Sitzungen daran gehindert werden, den Status dieser Ereignisse zu ändern.

Um zu steuern, ob RECONNECT- und DISCONNECT-Ereignisse auf dem Server empfangen werden, können Sie das RemoteControlPersistent-Flag in der Registrierung unter dem folgenden Schlüssel platzieren:

HKEY_LOCAL_MACHINE\System\Currentcontrolset\Steuerung\TerminalServer\Addins\addinname

Das Flag aktiviert oder deaktiviert die Signalisierung von RECONNECT- und DISCONNECT-Ereignissen, wenn eine Clientsitzung gestartet oder beendet wird. Die Syntax des REG_DWORD-Werts lautet wie folgt.

RemoteControlPersistent = flag

Der Wert des Flags kann 1 oder 0 sein. Null ist der Standardwert. Wenn sie auf einen festgelegt ist, wird die Dienstanwendung nicht benachrichtigt, wenn die Clientsitzung gestartet oder beendet wird. Bei Festlegung auf null wird ein RECONNECT-Ereignis signalisiert, wenn die Clientsitzung gestartet wird, und ein DISCONNECT-Ereignis wird signalisiert, wenn die Clientsitzung beendet wird.

Das vorherige Format des Ereignisobjektnamens wird in Windows Server 2008 aus Gründen der Abwärtskompatibilität weiterhin unterstützt. Es wird empfohlen, das neuere Windows Server 2008-Format zu verwenden, da es sicherer ist.

Das vorherige Ereignisformat lautet wie folgt.

Global\AddinName-SessionId-Reconnect
 
Global\AddinName-SessionId-Disconnect

AddinName ist die Zeichenfolge, die im Wert Name des Registrierungsunterschlüssels angegeben ist, unter dem die Serveranwendung registriert ist. SessionId ist der Sitzungsbezeichner einer Clientsitzung.