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

Weitere Informationen

Windows-Ereignissammlerfunktionen