ISharedPropertyGroup::CreatePropertyByPosition メソッド (comsvcs.h)

指定したインデックスを持つ新しい共有プロパティを作成します。 指定したインデックスを持つ共有プロパティが既に存在する場合、 CreatePropertyByPosition は既存のインデックスへの参照を返します。

構文

HRESULT CreatePropertyByPosition(
  [in]  int             Index,
  [out] VARIANT_BOOL    *fExists,
  [out] ISharedProperty **ppProp
);

パラメーター

[in] Index

新しいプロパティが参照される SharedPropertyGroup オブジェクト内の数値インデックス。 このインデックスは、後で get_PropertyByPosition メソッドを使用して共有プロパティを取得するために使用できます。

[out] fExists

ブール値への参照。 このメソッドからの戻り時に fExists が VARIANT_TRUE に設定されている場合は、この呼び出しの前に Index で指定された共有プロパティが存在します。 VARIANT_FALSEに設定されている場合は、この呼び出しによって プロパティが作成されました。

[out] ppProp

Index パラメーターで渡された数値インデックスによって識別される共有プロパティ オブジェクトへの参照。エラーが発生した場合は NULL。

戻り値

このメソッドは、標準の戻り値E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL、およびS_OKを返すことができます。

注釈

共有プロパティを作成すると、その値は既定値に設定されます。これは、値が 0 のVT_I4 VARIANT です。

CreatePropertyByPosition メソッドを使用して SharedProperty オブジェクトを作成する場合は、get_PropertyByPosition メソッドを使用してのみそのプロパティにアクセスできます。 同じプロパティに文字列名を割り当てた後、 get_Property メソッドを使用してアクセスすることはできません。 位置によるプロパティへのアクセスは、オーバーヘッドが少なくて済むため、文字列名を使用してプロパティにアクセスするよりも高速です。

同じ共有プロパティ グループには、位置によって識別される SharedProperty オブジェクトと、名前で識別される SharedProperty オブジェクトを含めることができます。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	comsvcs.h

こちらもご覧ください

ISharedProperty

ISharedPropertyGroup