IMsRdpClientNonScriptable8::StartWorkspaceExtension-Methode
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 |