IWorkspaceScriptable::StartWorkspace-Methode (workspaceruntime.h)
Ordnet Benutzeranmeldeinformationen und Zertifikate einer Verbindungs-ID zu.
Syntax
HRESULT StartWorkspace(
[in] BSTR bstrWorkspaceId,
[in] BSTR bstrUserName,
[in] BSTR bstrPassword,
[in] BSTR bstrWorkspaceParams,
[in] LONG lTimeout,
[in] LONG lFlags
);
Parameter
[in] bstrWorkspaceId
Eine Zeichenfolge, die die Verbindungs-ID enthält.
[in] bstrUserName
Eine Zeichenfolge, die einen Benutzernamen enthält.
[in] bstrPassword
Eine Zeichenfolge, die ein Kennwort enthält.
[in] bstrWorkspaceParams
Eine Zeichenfolge, die einen oder mehrere SHA-1-Hashes (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 Eigenschaften der Benutzeranmeldeinformationen angibt. Dies kann ein bitweises OR der folgenden Werte sein.
WKS_FLAG_CLEAR_CREDS_ON_LAST_RESOURCE (1 (0x1))
Löschen Sie Anmeldeinformationen, sobald die letzte RemoteApp-Anwendung geschlossen wurde.
WKS_FLAG_PASSWORD_ENCRYPTED (2 (0x2))
Das Kennwort ist verschlüsselt.
WKS_FLAG_CREDS_AUTHENTICATED (4 (0x4))
Die Anmeldeinformationen des Benutzers 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, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Wert zurückgegeben, der den Fehler angibt. Mögliche Werte sind u. a. die werte in der folgenden Liste.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7 |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 |
| Zielplattform | Windows |
| Kopfzeile | workspaceruntime.h |