Freigeben über


EcInsertObjectArrayElement-Funktion (evcoll.h)

Die EcInsertObjectArrayElement-Funktion fügt ein leeres Objekt in ein Array von Eigenschaftenwerten für die Ereignisquellen eines Abonnements ein. Das Objekt wird an einem angegebenen Arrayindex eingefügt.

Syntax

BOOL EcInsertObjectArrayElement(
  [in] EC_OBJECT_ARRAY_PROPERTY_HANDLE ObjectArray,
  [in] DWORD                           ArrayIndex
);

Parameter

[in] ObjectArray

Ein Handle für das Array, in das das Objekt eingefügt wird. Das Array enthält Eigenschaftswerte für die Ereignisquellen eines Abonnements. Das Arrayhandle wird von der EcGetSubscriptionProperty-Methode zurückgegeben, wenn der EcSubscriptionEventSources-Wert an den Subscription-Parameter übergeben wird.

[in] ArrayIndex

Ein Arrayindex, der angibt, wo das Objekt eingefügt werden soll.

Rückgabewert

Diese Funktion gibt BOOL zurück.

Hinweise

Arrays sind nullbasiert, sodass der Index für das erste Element im Array 0 ist.

Verwenden Sie ecSetObjectArrayProperty , um einzelne Eigenschaften eines leeren Objekts festzulegen, das in das im ObjectArray-Parameter angegebene Array eingefügt wird.

Beispiele

Beispielcode mit der EcInsertObjectArrayElement-Funktion finden Sie unter Hinzufügen einer Ereignisquelle zu einem vom Collector initiierten Abonnement.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile evcoll.h
Bibliothek Wecapi.lib
DLL Wecapi.dll

Weitere Informationen

Windows-Ereignissammlerfunktionen