EcInsertObjectArrayElement 関数 (evcoll.h)

  • [アーティクル]

EcInsertObjectArrayElement 関数は、サブスクリプションのイベント ソースのプロパティ値の配列に空のオブジェクトを挿入します。 オブジェクトは、指定した配列インデックスに挿入されます。

構文

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

パラメーター

[in] ObjectArray

オブジェクトが挿入される配列へのハンドル。 配列には、サブスクリプションのイベント ソースのプロパティ値が含まれています。 配列ハンドルは、EcSubscriptionEventSources 値が Subscription パラメーターに渡されると、EcGetSubscriptionProperty メソッドによって返されます。

[in] ArrayIndex

オブジェクトを挿入する場所を示す配列インデックス。

戻り値

この関数は BOOL を返します。

解説

配列は 0 から始まるため、配列内の最初の項目のインデックスは 0 です。

EcSetObjectArrayProperty を使用して、ObjectArray パラメーターで指定された配列に挿入された空のオブジェクトの個々のプロパティを設定します。

例

EcInsertObjectArrayElement 関数を使用するコード例については、「Collector Initiated Subscription へのイベント ソースの追加」を参照してください。

要件

   
サポートされている最小のクライアント Windows Vista
サポートされている最小のサーバー Windows Server 2008
対象プラットフォーム Windows
ヘッダー evcoll.h
Library Wecapi.lib
[DLL] Wecapi.dll

関連項目

Windows イベント コレクター関数