Metode ISharedPropertyGroup::CreatePropertyByPosition (comsvcs.h)
Membuat properti bersama baru dengan indeks yang ditentukan. Jika properti bersama dengan indeks yang ditentukan sudah ada, CreatePropertyByPosition mengembalikan referensi ke yang sudah ada.
Sintaks
HRESULT CreatePropertyByPosition(
[in] int Index,
[out] VARIANT_BOOL *fExists,
[out] ISharedProperty **ppProp
);
Parameter
[in] Index
Indeks numerik dalam objek SharedPropertyGroup tempat properti baru dirujuk. Anda dapat menggunakan indeks ini nanti untuk mengambil properti bersama dengan metode get_PropertyByPosition .
[out] fExists
Referensi ke nilai Boolean. Jika fExists diatur ke VARIANT_TRUE saat dikembalikan dari metode ini, properti bersama yang ditentukan oleh Indeks ada sebelum panggilan ini. Jika diatur ke VARIANT_FALSE, properti dibuat oleh panggilan ini.
[out] ppProp
Referensi ke objek properti bersama yang diidentifikasi oleh indeks numerik yang diteruskan dalam parameter Indeks , 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 objek SharedProperty dengan metode CreatePropertyByPosition , Anda dapat mengakses properti tersebut hanya dengan menggunakan metode get_PropertyByPosition . Anda tidak dapat menetapkan nama string ke properti yang sama lalu mengaksesnya dengan menggunakan metode get_Property . Mengakses properti berdasarkan posisi lebih cepat daripada mengakses properti dengan menggunakan nama string karena membutuhkan lebih sedikit overhead.
Grup properti bersama yang sama dapat berisi beberapa objek SharedProperty yang diidentifikasi berdasarkan posisi dan lainnya yang diidentifikasi berdasarkan nama.
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 |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk