IPropertyStore_GetCount

ファイルに付与されているプロパティの数を返す。

IPropertyStore_GetCount this, cProps

this : [comobj] IPropertyStore インターフェースの COM オブジェクト変数
cProps : [int] プロパティ数を示す値へのポインター。

(プラグイン / モジュール : com_misc.dll)

解説

ファイルに付与されているプロパティの数を返す。

[戻り値]
IPropertyStore::GetCount メソッドは成功時、ファイルにプロパティが 1 つも付与されていない場合でも S_OK
を返す。その他のコードはエラーコードである。

[備考]
IPropertyStore は IPropertyStore::GetCount および IPropertyStore::GetAt
メソッド経由でプロパティキーの配列に対する抽象化を提供する。この配列内のプロパティキーは、IPropertyStore
が現在格納しているプロパティを表す。GetCount が成功した場合、cProps
が指す値は配列内のプロパティキーの個数である。呼び出し側は iProp が cProps より小さい値に対する
IPropertyStore::GetAt の呼び出しが成功することを期待できる。E_OUTOFMEMORY
などの失敗の場合は、cProps を 0 に設定するべきである。エラーはプロパティストアの作成時または初期化時に検出することが望ましい。

情報