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

Weitere Informationen

IWorkspaceScriptable

IWorkspaceScriptable2

IWorkspaceScriptable3