Fungsi EcGetObjectArrayProperty (evcoll.h)

Fungsi EcGetObjectArrayProperty mengambil nilai properti dari handel ke array properti sumber peristiwa. Array berisi nilai properti untuk sumber peristiwa langganan.

Sintaks

BOOL EcGetObjectArrayProperty(
  [in]  EC_OBJECT_ARRAY_PROPERTY_HANDLE ObjectArray,
  [in]  EC_SUBSCRIPTION_PROPERTY_ID     PropertyId,
  [in]  DWORD                           ArrayIndex,
  [in]  DWORD                           Flags,
  [in]  DWORD                           PropertyValueBufferSize,
  [in]  PEC_VARIANT                     PropertyValueBuffer,
  [out] PDWORD                          PropertyValueBufferUsed
);

Parameter

[in] ObjectArray

Handel ke array properti untuk sumber peristiwa untuk langganan. Handel array yang dikembalikan oleh metode EcGetSubscriptionProperty ketika nilai EcSubscriptionEventSources diteruskan ke parameter PropertyId .

[in] PropertyId

Pengidentifikasi properti untuk properti dalam array. Tentukan nilai dari enumerasi EC_SUBSCRIPTION_PROPERTY_ID . Dapatkan properti Alamat, Diaktifkan, Nama Pengguna, dan Kata Sandi dalam array dengan menentukan nilai EcSubscriptionEventSourceAddress, EcSubscriptionEventSourceEnabled, EcSubscriptionEventSourceUserName, atau EcSubscriptionEventSourcePassword .

[in] ArrayIndex

Indeks array yang menentukan sumber kejadian mana yang akan mendapatkan properti .

[in] Flags

Dicadangkan. Harus 0.

[in] PropertyValueBufferSize

Ukuran buffer yang berisi nilai properti . Ukuran harus setidaknya ukuran nilai EC_VARIANT .

[in] PropertyValueBuffer

Buffer yang disediakan pengguna untuk menyimpan nilai properti.

[out] PropertyValueBufferUsed

Ukuran buffer yang disediakan pengguna yang digunakan oleh fungsi pada pengembalian yang berhasil, atau ukuran yang diperlukan untuk menyimpan nilai properti ketika fungsi gagal dengan ERROR_INSUFFICIENT_BUFFER.

Mengembalikan nilai

Fungsi ini mengembalikan BOOL.

Keterangan

Array berbasis nol, sehingga indeks untuk item pertama dalam array adalah 0.

Properti Kata Sandi untuk sumber kejadian atau langganan tidak dapat diambil. Untuk alasan keamanan, string kosong dikembalikan untuk nilai properti dan kesalahan terakhir akan diatur ke ERROR_ACCESS_DENIED.

Langganan dapat memiliki beberapa sumber peristiwa, dan setiap sumber dapat memiliki properti Alamat, Diaktifkan, Nama Pengguna, dan Kata Sandi .

Contoh

Misalnya kode menggunakan fungsi EcGetObjectArrayProperty , lihat Menampilkan Properti Langganan Pengumpul Peristiwa.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	evcoll.h
Pustaka	Wecapi.lib
DLL	Wecapi.dll

Lihat juga

Fungsi Pengumpul Peristiwa Windows