Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Koordiniert die Remotesitzung des Clients mit der Systemsteuerung RemoteApp- und Desktopverbindungen.
Hinweis
Die Systemsteuerung RemoteApp- und Desktopverbindungen wird nicht mehr aktiv entwickelt. Sie kann in zukünftigen Windows-Versionen geändert oder nicht mehr verfügbar sein. Von der Verwendung dieser API wird abgeraten.
Syntax
HRESULT StartWorkspaceExtension(
[in] VARIANT_BOOL isWebHosted,
[in] BSTR workspaceId,
[in] BYTE *publisherThumbPrint,
[in] UINT publisherThumbPrintLength
);
Parameter
isWebHosted
Ein Wert, der angibt, ob die Verbindung von einer Website gehostet wird.
workspaceId
Eine Zeichenfolge, die die ID einer Verbindung im Systemsteuerungsbereich RemoteApp- und Desktopverbindungen enthält.
publisherThumbPrint
Ein Array von Bytes, das den Fingerabdruck im Binärformat darstellt, das als bstrWorkspaceParams an IWorkspaceScriptable3::StartWorkspaceEx2 übergeben werden soll. Siehe Hinweise.
publisherThumbPrintLength
Die Anzahl der Bytes, auf die publisherThumbPrint verweist.
Rückgabewert
Gibt bei erfolgreicher Ausführung S_OK zurück.
Bemerkungen
Diese Funktion verarbeitet die folgenden Szenarien:
- Bei der Verbindung mit der Remotesitzung:
- Nachdem der Benutzer zur Eingabe von Anmeldeinformationen aufgefordert wurde, ordnet er ihn über IWorkspaceScriptable3::StartWorkspaceEx2 in der Systemsteuerung RemoteApp- und Desktopverbindungen einer Verbindung zu.
- Es benachrichtigt die RemoteApp- und Desktopverbindungen-Systemsteuerung über das Vorhandensein der Remotesitzung über IWorkspaceRegistration2::AddResourceEx.
- Nach der Trennung von der Remotesitzung:
- Der Benutzer wird benachrichtigt, dass die Remotesitzung über IWorkspaceScriptable2::ResourceDismissed geschlossen wurde.
- Es benachrichtigt die RemoteApp- und Desktopverbindungen-Systemsteuerung über die Trennung über IWorkspaceRegistration2::RemoveResourceEx.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 11 Version 23H2 |
| Typbibliothek | MsTscAx.dll |
| DLL | MsTscAx.dll |
| IID | IID_IMsRdpClientNonScriptable8 ist definiert als B2B3FA47-3F11-4148-AD24-DFF8684A16D0 |