Freigeben über

WSManCreateSession-Funktion (wsman.h)

  • Artikel

Erstellt ein Sitzungsobjekt.

Syntax

DWORD WSManCreateSession(
  [in]           WSMAN_API_HANDLE                 apiHandle,
  [in, optional] PCWSTR                           connection,
                 DWORD                            flags,
  [in, optional] WSMAN_AUTHENTICATION_CREDENTIALS *serverAuthenticationCredentials,
  [in, optional] WSMAN_PROXY_INFO                 *proxyInfo,
  [out]          WSMAN_SESSION_HANDLE             *session
);

Parameter

[in] apiHandle

Gibt das API-Handle an, das vom WSManInitialize-Aufruf zurückgegeben wird. Dieser Parameter darf nicht NULL sein.

[in, optional] connection

Gibt an, mit welchem Protokoll und Agent eine Verbindung hergestellt werden soll. Wenn dieser Parameter NULL ist, wird die Verbindung standardmäßig auf localhost (127.0.0.1) festgelegt. Bei diesem Parameter kann es sich um einen einfachen Hostnamen oder eine vollständige URL handeln. Das Format lautet wie folgt:

[transport://]host[:p ort][/prefix], wobei:

Element BESCHREIBUNG
Transport Entweder HTTP oder HTTPS. Der Standardwert ist HTTP.
host Kann sich in einem DNS-Namen, NetBIOS-Namen oder einer IP-Adresse enthalten.
port Der Standardwert ist 80 für HTTP und 443 für HTTPS. Die Standardwerte können in der lokalen Konfiguration geändert werden.
prefix Eine beliebige Zeichenfolge. Der Standardwert ist "wsman". Der Standardwert kann in der lokalen Konfiguration geändert werden.

flags

Für die zukünftige Verwendung reserviert. Muss Null sein.

[in, optional] serverAuthenticationCredentials

Definiert die Authentifizierungsmethode, z. B. Negotiate, Kerberos, Digest, Basic oder Clientzertifikat. Wenn der Authentifizierungsmechanismus Negotiate, Kerberos, Digest oder Basic lautet, kann die Struktur auch die Anmeldeinformationen enthalten, die für die Authentifizierung verwendet werden. Wenn die Clientzertifikatauthentifizierung verwendet wird, muss der Zertifikatfingerabdruck angegeben werden.

Wenn Anmeldeinformationen angegeben sind, enthält dieser Parameter den Benutzernamen und das Kennwort eines lokalen Kontos oder Domänenkontos. Wenn dieser Parameter NULL ist, werden die Standardanmeldeinformationen verwendet. Die Standardanmeldeinformationen sind die Anmeldeinformationen, unter denen der aktuelle Thread ausgeführt wird. Der Client muss die Anmeldeinformationen explizit angeben, wenn die Standard- oder Digestauthentifizierung verwendet wird. Wenn explizite Anmeldeinformationen verwendet werden, müssen sowohl der Benutzername als auch das Kennwort gültig sein. Weitere Informationen zu den Anmeldeinformationen für die Authentifizierung finden Sie in der WSMAN_AUTHENTICATION_CREDENTIALS-Struktur .

[in, optional] proxyInfo

Ein Zeiger auf eine WSMAN_PROXY_INFO-Struktur , die Proxyinformationen angibt. Dieser Wert kann NULL sein.

[out] session

Definiert das Sitzungshandle, das die Sitzung eindeutig identifiziert. Dieser Parameter darf nicht NULL sein. Dieses Handle sollte durch Aufrufen der WSManCloseSession-Methode geschlossen werden.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert „0“. Andernfalls ist der Rückgabewert ein Fehlercode.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 7
Unterstützte Mindestversion (Server) Windows Server 2008 R2
Zielplattform Windows
Kopfzeile wsman.h
Bibliothek WsmSvc.lib
DLL WsmSvc.dll
Verteilbare Komponente Windows Management Framework unter Windows Server 2008 mit SP2 und Windows Vista mit SP2