Fungsi WSManCreateSession (wsman.h)

Membuat objek sesi.

Sintaks

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

Menentukan handel API yang dikembalikan oleh panggilan WSManInitialize . Parameter ini tidak boleh NULL.

[in, optional] connection

Menunjukkan protokol dan agen mana yang akan disambungkan. Jika parameter ini NULL, koneksi akan default ke localhost (127.0.0.1). Parameter ini bisa menjadi nama host sederhana atau URL lengkap. Formatnya adalah sebagai berikut:

[transport://]host[:p ort][/prefiks] di mana:

flags

Disiapkan untuk penggunaan masa mendatang. Harus nol.

[in, optional] serverAuthenticationCredentials

Menentukan metode autentikasi seperti Negosiasi, Kerberos, Digest, Dasar, atau sertifikat klien. Jika mekanisme autentikasi adalah Negosiasi, Kerberos, Digest, atau Basic, struktur juga dapat berisi kredensial yang digunakan untuk autentikasi. Jika autentikasi sertifikat klien digunakan, thumbprint sertifikat harus ditentukan.

Jika kredensial ditentukan, parameter ini berisi nama pengguna dan kata sandi akun lokal atau akun domain. Jika parameter ini NULL, kredensial default akan digunakan. Kredensial default adalah kredensial yang dijalankan utas saat ini. Klien harus secara eksplisit menentukan kredensial saat autentikasi Dasar atau Hash digunakan. Jika kredensial eksplisit digunakan, nama pengguna dan kata sandi harus valid. Untuk informasi selengkapnya tentang kredensial autentikasi, lihat struktur WSMAN_AUTHENTICATION_CREDENTIALS .

[in, optional] proxyInfo

Penunjuk ke struktur WSMAN_PROXY_INFO yang menentukan informasi proksi. Nilai ini bisa NULL.

[out] session

Menentukan handel sesi yang secara unik mengidentifikasi sesi. Parameter ini tidak boleh NULL. Handel ini harus ditutup dengan memanggil metode WSManCloseSession .

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah nol. Jika tidak, nilai yang dikembalikan adalah kode kesalahan.

Persyaratan