Metode IWSMan::CreateSession (wsmandisp.h)

Artikel
08/28/2023

Membuat objek Sesi yang kemudian dapat digunakan untuk operasi jaringan berikutnya.

Sintaks

HRESULT CreateSession(
  [in]  BSTR      connection,
  [in]  long      flags,
  [in]  IDispatch *connectionOptions,
  [out] IDispatch **session
);

Parameter

[in] connection

Protokol dan layanan yang akan disambungkan, termasuk IPv4 atau IPv6. Format informasi koneksi adalah sebagai berikut: <Akhiran>Alamat><Transportasi><. Misalnya, lihat Komentar. Jika tidak ada informasi koneksi yang disediakan, komputer lokal akan digunakan.

[in] flags

Bendera sesi yang menentukan metode autentikasi, seperti Negosiasi autentikasi atau Autentikasi hash, untuk menyambungkan ke komputer jarak jauh. Bendera ini juga menentukan informasi koneksi sesi lainnya, seperti pengodean atau enkripsi. Parameter ini harus berisi satu atau beberapa bendera di __WSManSessionFlags untuk koneksi jarak jauh. Untuk informasi selengkapnya, lihat Konstanta Sesi. Tidak diperlukan pengaturan bendera untuk koneksi ke layanan WinRM di komputer lokal.

Jika tidak ada bendera autentikasi yang ditentukan, Kerberos digunakan kecuali salah satu kondisi berikut ini benar, dalam hal ini Negosiasi digunakan:

kredensial eksplisit disediakan dan host tujuan tepercaya
host tujuan adalah "localhost", "127.0.0.1" atau "[::1]"
komputer klien berada dalam grup kerja dan host tujuan tepercaya

Untuk informasi selengkapnya, lihat Autentikasi untuk Koneksi Jarak Jauh dan parameter connectionOptions .

[in] connectionOptions

Penunjuk ke objek IWSManConnectionOptions yang berisi nama pengguna dan kata sandi. Defaultnya adalah NULL.

[out] session

Penunjuk ke objek IWSManSession baru.

Nilai kembali

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Daftar berikut berisi contoh format yang digunakan untuk menentukan informasi koneksi dalam parameter koneksi (saat membuat sesi HTTPS, < bidang Alamat> harus cocok dengan nama sertifikat komputer server, jika tidak, kegagalan terjadi):

"https://service"
Menggunakan HTTPS untuk menyambungkan ke lokasi layanan web default.
"https://service.corp.com/websvcs/wsman"
Menggunakan HTTPS untuk menyambungkan ke lokasi layanan web tertentu.
"https://[E3D7:0000:0000:0000:51F4:9BC8:C0A8:6420]"
Menggunakan HTTPS dan IPv6 dengan port default.
"https://[E3D7:0000:0000:0000:51F4:9BC8:C0A8:6420]:9999/wsman"
Menggunakan HTTPS dan IPv6 dengan port yang diberikan.

Persyaratan


Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	wsmandisp.h
Pustaka	WSManDisp.tlb
DLL	WSMAuto.dll

Lihat juga

IWSMan

WSMan.CreateSession

Bagikan melalui