IWorkspaceScriptable2::StartWorkspaceEx-Methode (workspaceruntime.h)
Ordnet Benutzeranmeldeinformationen und -zertifikate einer Verbindungs-ID zu; enthält außerdem zusätzliche Sicherheits- und Benutzeroberflächenelemente.
Syntax
HRESULT StartWorkspaceEx(
[in] BSTR bstrWorkspaceId,
[in] BSTR bstrWorkspaceFriendlyName,
[in] BSTR bstrRedirectorName,
[in] BSTR bstrUserName,
[in] BSTR bstrPassword,
[in] BSTR bstrAppContainer,
[in] BSTR bstrWorkspaceParams,
[in] LONG lTimeout,
[in] LONG lFlags
);
Parameter
[in] bstrWorkspaceId
Eine Zeichenfolge, die die Verbindungs-ID enthält.
[in] bstrWorkspaceFriendlyName
Der Anzeigename des Arbeitsbereichs, der auf der Benutzeroberfläche angezeigt werden soll.
[in] bstrRedirectorName
Zeichenfolge, die den Namen des Redirectors enthält.
[in] bstrUserName
Eine Zeichenfolge, die einen Benutzernamen enthält.
[in] bstrPassword
Eine Zeichenfolge, die ein Kennwort enthält.
[in] bstrAppContainer
Eine Zeichenfolge, die den App-Container für den Arbeitsbereich enthält.
[in] bstrWorkspaceParams
Eine Zeichenfolge, die mindestens einen SHA-1-Hash (Secure Hash Algorithm 1) von Signaturzertifikaten enthält, die der angegebenen Verbindungs-ID zugeordnet werden sollen. Die Hashwerte sollten im hexadezimalen Zeichenfolgenformat vorliegen und durch Semikolons getrennt sein.
[in] lTimeout
Der Zeitraum in Minuten, nach dem die Anmeldeinformationen gelöscht werden.
[in] lFlags
Ein Flag, das die Eigenschaften der Benutzeranmeldeinformationen angibt. Dies kann ein bitweiser OR der folgenden Werte sein.
WKS_FLAG_CLEAR_CREDS_ON_LAST_RESOURCE (1 (0x1))
Löschen Sie Anmeldeinformationen, sobald die letzte RemoteApp-Anwendung geschlossen wird.
WKS_FLAG_PASSWORD_ENCRYPTED (2 (0x2))
Das Kennwort ist verschlüsselt.
WKS_FLAG_CREDS_AUTHENTICATED (4 (0x4))
Die Benutzeranmeldeinformationen werden überprüft. Wenn dieses Flag nicht festgelegt ist, müssen Sie die OnAuthenticated-Methode aufrufen, bevor Sie die Anmeldeinformationen verwenden.
Rückgabewert
Wenn die Methode erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein HRESULT-Wert zurückgegeben, der den Fehler angibt. Mögliche Werte sind unter anderem die Werte in der folgenden Liste.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 |
| Unterstützte Mindestversion (Server) | Windows Server 2012 |
| Zielplattform | Windows |
| Kopfzeile | workspaceruntime.h |