Metode SWbemPropertySet.Add
Metode Tambahkan objek SWbemPropertySet menambahkan objek SWbemProperty ke koleksi SWbemPropertySet . Jika properti dengan nama yang sama sudah ada dalam koleksi, kontennya diganti dengan definisi baru.
Catatan
Nilai properti yang ditambahkan adalah NULL (tidak ditetapkan) setelah operasi ini. Untuk mengatur atau mengubah nilai properti WMI, Anda harus mengatur properti Nilai dari objek SWbemProperty yang dikembalikan.
Untuk penjelasan tentang sintaks ini, lihat Konvensi Dokumen untuk Scripting API.
Sintaks
objProperty = .Add( _
ByVal strName, _
ByVal iCIMType, _
[ ByVal bIsArray ], _
[ ByVal iFlags ] _
)
Parameter
-
strName [in]
-
Wajib diisi. Nama properti baru.
-
iCIMType [in]
-
Wajib diisi. Bilangan bulat yang mewakili kualifikasi CIMType dari properti baru. Lihat WbemCimTypeEnum untuk daftar dengan kualifikasi CIMType dan nilainya.
-
bIsArray [in, opsional]
-
Menentukan apakah properti adalah jenis array. Nilai default untuk parameter ini adalah FALSE.
-
iFlags [in, opsional]
-
Dicadangkan dan harus nol jika ditentukan.
Nilai kembali
Jika berhasil, metode ini mengembalikan objek SWbemProperty yang mewakili properti baru. Jika tidak, objek null dikembalikan.
Kode kesalahan
Setelah menyelesaikan metode Tambahkan , objek Err mungkin berisi salah satu kode kesalahan di bawah ini.
-
wbemErrFailed - 2147749889 (0x80041001)
-
Kegagalan yang tidak ditentukan.
-
wbemErrInvalidParameter - 2147749896 (0x80041008)
-
Parameter tidak valid ditentukan.
-
wbemErrOutOfMemory - 2147749894 (0x80041006)
-
Tidak cukup memori untuk mengeksekusi metode ini.
-
wbemErrInvalidPropertyType - 2147749930
-
Kualifikasi CIMType tidak dikenali.
Contoh
Untuk contoh kode yang menggunakan metode ini, lihat topik SWbemPropertySet .
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows Vista |
| Server minimum yang didukung |
Windows Server 2008 |
| Header |
|
| Pustaka jenis |
|
| DLL |
|
| CLSID |
CLSID_SWbemPropertySet |
| IID |
IID_ISWbemPropertySet |