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를 제공하므로 코딩 오류가 발생할 가능성이 없습니다.

요구 사항