Freigeben über

IMsRdpClientNonScriptable8::StartWorkspaceExtension-Methode

  • Artikel

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:

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

Weitere Informationen

IMsRdpClientNonScriptable8