Fungsi ConnectServerWmi

Membuat koneksi melalui DCOM ke namespace layanan WMI pada komputer tertentu.

Catatan

API ini hanya untuk penggunaan internal. API ini tidak dimaksudkan untuk digunakan dari kode pengembang.

Sintaks

HRESULT ConnectServerWmi (
   [in] BSTR               strNetworkResource,
   [in] BSTR               strUser,
   [in] BSTR               strPassword,
   [in] BSTR               strLocale,
   [in] long               lSecurityFlags,
   [in] BSTR               strAuthority,
   [in] IWbemContext*      pCtx,
   [out] IWbemServices**   ppNamespace,
   [in] DWORD              impLevel,
   [in] DWORD              authLevel
);

Parameter

strNetworkResource
[in] Penunjuk ke BSTR valid yang berisi jalur objek namespace layanan WMI yang benar. Untuk informasi selengkapnya, lihat bagian Keterangan.

strUser
[in] Penunjuk ke BSTR valid yang berisi nama pengguna. Nilai null menunjukkan konteks keamanan saat ini. Jika pengguna berasal dari domain yang berbeda dari domain saat ini, strUser juga dapat berisi domain dan nama pengguna yang dipisahkan oleh garis miring terbalik. strUser juga dapat dalam format nama prinsipal pengguna (UPN), seperti userName@domainName. Untuk informasi selengkapnya, lihat bagian Keterangan.

strPassword
[in] Penunjuk ke BSTR valid yang berisi kata sandi. null menunjukkan konteks keamanan saat ini. String kosong ("") menunjukkan kata sandi kosong yang valid.

strLocale
[in] Penunjuk ke BSTR valid yang menunjukkan lokal yang benar untuk pengambilan informasi. Untuk pengidentifikasi lokal Microsoft, format string adalah "MS_xxx", di mana xxx adalah string dalam bentuk heksadesimal yang menunjukkan pengidentifikasi lokal (LCID). Jika lokal yang tidak valid ditentukan, metode mengembalikan WBEM_E_INVALID_PARAMETER kecuali pada Windows 7, di mana lokal default server digunakan sebagai gantinya. Jika `null1, lokal saat ini sedang digunakan.

lSecurityFlags
[in] Bendera untuk diteruskan ke metode ConnectServerWmi. Nilai nol (0) untuk parameter ini menghasilkan panggilan ke ConnectServerWmi kembali hanya setelah koneksi ke server dibuat. Hal ini dapat mengakibatkan aplikasi tidak merespons tanpa batas waktu jika server rusak. Nilai valid lainnya adalah:

Terus-menerus	Nilai	Deskripsi
CONNECT_REPOSITORY_ONLY	0x40	Dicadangkan untuk penggunaan internal. Jangan gunakan.
WBEM_FLAG_CONNECT_USE_MAX_WAIT	0x80	ConnectServerWmi kembali dalam dua menit atau kurang.

strAuthority
[in] Nama domain pengguna. Parameter dapat memiliki nilai berikut:

Nilai	Deskripsi
kosong	Autentikasi NTLM digunakan, dan domain NTLM dari pengguna saat ini digunakan. Jika strUser menentukan domain (lokasi yang direkomendasikan), domain tersebut tidak boleh ditentukan di sini. Fungsi mengembalikan WBEM_E_INVALID_PARAMETER jika Anda menentukan domain di kedua parameter.
Kerberos:nama prinsipal	Autentikasi Kerberos digunakan, dan parameter ini berisi nama prinsipal Kerberos.
NTLMDOMAIN:nama domain	Autentikasi NT LAN Manager digunakan, dan parameter ini berisi nama domain NTLM.

pCtx
[in] Biasanya parameter ini adalah null. Jika tidak, parameter ini adalah penunjuk ke objek IWbemContext yang diperlukan oleh satu atau beberapa penyedia kelas dinamis.

ppNamespace
[out] Saat fungsi kembali, menerima penunjuk ke objek IWbemServices yang terikat ke namespace layanan yang ditentukan. Hal ini diatur untuk menunjuk ke null saat ada kesalahan.

impLevel
[in] Tingkat peniruan.

authLevel
[in] Tingkat otorisasi.

Mengembalikan nilai

Nilai berikut yang dikembalikan oleh fungsi ini ditentukan dalam file header WbemCli.h, atau Anda dapat menentukannya sebagai konstanta dalam kode Anda:

Terus-menerus	Nilai	Deskripsi
WBEM_E_FAILED	0x80041001	Terjadi kegagalan umum.
WBEM_E_INVALID_PARAMETER	0x80041008	Parameter tidak valid.
WBEM_E_OUT_OF_MEMORY	0x80041006	Memori tidak cukup tersedia untuk menyelesaikan operasi.
WBEM_S_NO_ERROR	0	Panggilan fungsi berhasil.

Keterangan

Fungsi ini membungkus panggilan ke metode IWbemLocator::ConnectServer.

Untuk akses lokal ke namespace layanan default, strNetworkResource bisa menjadi jalur objek sederhana: "root\default" atau "\.\root\default". Untuk akses ke namespace layanan default pada komputer jarak jauh menggunakan jaringan yang kompatibel dengan COM atau Microsoft, sertakan nama komputer: "\myserver\root\default". Nama komputer juga bisa menjadi nama DNS atau alamat IP. Fungsi ConnectServerWmi juga dapat tersambung dengan komputer yang menjalankan IPv6 menggunakan alamat IPv6.

strUser tidak boleh berupa string kosong. Jika domain ditentukan dalam strAuthority, domain tidak boleh disertakan dalam strUser, atau fungsi mengembalikan WBEM_E_INVALID_PARAMETER.

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: WMINet_Utils.idl

Versi .NET Framework: Tersedia sejak 4.7.2

Lihat juga

• WMI dan Penghitung Kinerja (Referensi API Tidak Terkelola)