IPropertyStoreFactory：：GetPropertyStoreForKeys 方法 (propsys.h)

取得 IPropertyStore 物件，指定一組屬性索引鍵。 相較於呼叫 IPropertyStoreFactory：：GetPropertyStore，這會提供可能更快取得 IPropertyStore 物件的替代方法。

語法

HRESULT GetPropertyStoreForKeys(
  [in]  const PROPERTYKEY     *rgKeys,
  [in]  UINT                  cKeys,
  [in]  GETPROPERTYSTOREFLAGS flags,
  [in]  REFIID                riid,
  [out] void                  **ppv
);

參數

[in] rgKeys

類型： const PROPERTYKEY*

PROPERTYKEY 結構的陣列指標。

[in] cKeys

類型： UINT

rgKeys 所指向陣列中的 PROPERTYKEY 結構數目。

[in] flags

類型： GETPROPERTYSTOREFLAGS

修改傳回存放區的 GETPROPERTYSTOREFLAGS 值。

[in] riid

類型： REFIID

要建立之物件的 IID 參考。

[out] ppv

類型： void**

當這個方法傳回時，會包含 IPropertyStore 介面指標的位址。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

建議您使用 Objbase.h 中定義的 IID_PPV_ARGS 宏來封裝 riid 和 ppv 參數。 這個宏會根據 ppv 中值所指向的介面提供正確的 IID，這可消除編碼錯誤的可能性。

規格需求