Metode ISharedPropertyGroup::CreateProperty (comsvcs.h)
Membuat properti bersama baru dengan nama yang ditentukan. Jika properti bersama dengan nama tersebut sudah ada, CreateProperty mengembalikan referensi ke properti yang sudah ada.
Sintaks
HRESULT CreateProperty(
[in] BSTR Name,
[out] VARIANT_BOOL *fExists,
[out] ISharedProperty **ppProp
);
Parameter
[in] Name
Nama properti yang akan dibuat. Anda dapat menggunakan nama ini nanti untuk mendapatkan referensi ke properti ini dengan menggunakan metode get_Property .
[out] fExists
Referensi ke nilai Boolean yang diatur ke VARIANT_TRUE saat dikembalikan dari metode ini jika properti bersama yang ditentukan dalam parameter Nama ada sebelum panggilan ini, dan VARIANT_FALSE jika properti dibuat oleh panggilan ini.
[out] ppProp
Referensi ke objek SharedProperty dengan nama yang ditentukan dalam parameter Nama , atau NULL jika terjadi kesalahan.
Nilai kembali
Metode ini dapat mengembalikan nilai pengembalian standar E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL, dan S_OK.
Keterangan
Saat Anda membuat properti bersama, nilainya diatur ke default, yang merupakan varian VT_I4 dengan nilai 0.
Jika Anda membuat properti bersama dengan metode CreateProperty , Anda hanya dapat mengakses properti tersebut dengan menggunakan metode get_Property . Anda tidak dapat menetapkan indeks numerik ke properti yang sama lalu mengaksesnya dengan menggunakan metode get_PropertyByPosition .
Grup properti bersama yang sama dapat berisi beberapa objek SharedProperty yang diidentifikasi berdasarkan nama dan lainnya yang diidentifikasi berdasarkan posisi.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | comsvcs.h |