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

指定した名前の新しい共有プロパティを作成します。 その名前の共有プロパティが既に存在する場合、 CreateProperty は 既存のプロパティへの参照を返します。

構文

HRESULT CreateProperty(
  [in]  BSTR            Name,
  [out] VARIANT_BOOL    *fExists,
  [out] ISharedProperty **ppProp
);

パラメーター

[in] Name

作成するプロパティの名前。 この名前は、後で get_Property メソッドを使用してこのプロパティへの参照を取得するために使用できます。

[out] fExists

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

[out] ppProp

Name パラメーターで指定された名前を持つ SharedProperty オブジェクトへの参照。エラーが発生した場合は NULL。

戻り値

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

注釈

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

CreateProperty メソッドを使用して共有プロパティを作成する場合は、get_Property メソッドを使用してのみそのプロパティにアクセスできます。 同じプロパティに数値インデックスを割り当てた後、 get_PropertyByPosition メソッドを使用してアクセスすることはできません。

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

要件

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

こちらもご覧ください

ISharedProperty

ISharedPropertyGroup