WdsCliCreateSession-Funktion (wdsclientapi.h)
Startet eine neue Sitzung mit einem WDS-Server.
Syntax
HRESULT WDSCLIAPI WdsCliCreateSession(
[in] PWSTR pwszServer,
[in, optional] PWDS_CLI_CRED pCred,
[out] PHANDLE phSession
);
Parameter
[in] pwszServer
Ein Zeiger auf einen Zeichenfolgenwert, der den Namen oder die IP-Adresse des WDS-Servers enthält.
[in, optional] pCred
Ein Zeiger auf eine WDS_CLI_CRED Struktur, die die Anmeldeinformationen des Clients enthält. Dieser Parameter kann null für eine Sitzung ohne Authentifizierung sein.
[out] phSession
Ein Zeiger auf ein Handle für die neue Sitzung. Dieser Parameter wird nicht geändert, wenn die Funktion nicht erfolgreich ist.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE.
Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Verwenden Sie zum Schließen der Sitzungs- und Freigaberessourcen die WdsCliClose-Funktion .
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wdsclientapi.h |
| Bibliothek | WdsClientAPI.lib |
| DLL | WdsClientAPI.dll |