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

ISharedProperty

ISharedPropertyGroup