IPropertyStore::GetCount メソッド (propsys.h)

  • [アーティクル]

このメソッドは、ファイルに添付されているプロパティの数を返します。

構文

HRESULT GetCount(
  DWORD *cProps
);

パラメーター

cProps

プロパティ数を示す値へのポインター。

戻り値

メソッドは IpropertyStore::GetCount 、ファイルにプロパティがアタッチされていない場合でも、呼び出しが成功したときにS_OKの値を返します。 返されるその他のコードはエラー コードです。

注釈

IPropertyStore は、 メソッドと IPropertyStore::GetAt メソッドをIPropertyStore::GetCount使用して、プロパティ キーの配列に対する抽象化を提供します。 この配列のプロパティ キーは、 現在 IPropertyStore によって格納されているプロパティを表します。

成功すると GetCount 、cProps によって指される値は、配列内のプロパティ キーの数になります。 呼び出し元は、cProps より小さい iProp の値に対して IPropertyStore::GetAt の呼び出しが成功することを期待できます。

E_OUTOFMEMORYなどのエラーが発生した場合は、cProps を 0 に設定する必要があります。 プロパティ ストアの作成または初期化中にエラーが検出されることをお勧めします。

要件

要件 値
サポートされている最小のクライアント Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。
対象プラットフォーム ユニバーサル
Header propsys.h
Library Propsys.idl
IRQL すべてのレベル

こちらもご覧ください

IPropertyStore

IPropertyStore::GetAt