IPropertyStorage::ReadMultiple 메서드(propidlbase.h)

아티클
08/25/2023

ReadMultiple 메서드는 현재 속성 집합에서 지정된 속성을 읽습니다.

구문

HRESULT ReadMultiple(
  [in]  ULONG             cpspec,
  [in]  const PROPSPEC [] rgpspec,
  [out] PROPVARIANT []    rgpropvar
);

매개 변수

[in] cpspec

rgpspec 배열에 지정할 속성의 숫자 수입니다. 이 매개 변수의 값은 0으로 설정할 수 있습니다. 그러나 rgpspec에 설정된 값에 관계없이 읽는 속성이 없으므로 메서드의 용도를 무효화합니다.

[in] rgpspec

PROPSPEC 구조의 배열은 읽을 속성을 지정합니다. 속성 ID 또는 선택적 문자열 이름으로 속성을 지정할 수 있습니다. 배열에서 속성을 특정 순서로 지정할 필요는 없습니다. 배열에는 중복 속성이 포함될 수 있으며, 이로 인해 단순 속성에 대한 반환 시 중복 속성 값이 생성됩니다. 비심플 속성은 두 번째로 열려는 시도에서 거부된 액세스를 반환해야 합니다. 배열에는 속성 ID와 문자열 ID가 혼합되어 포함될 수 있습니다.

[out] rgpropvar

반환 시 rgpspec 배열의 해당 요소에 지정된 속성의 값을 포함하는 PROPVARIANT 구조체의 호출자 할당 배열입니다. 배열은 PROPVARIANT 구조체의 cpspec 매개 변수 값을 보유할 수 있을 만큼 충분히 커야 합니다. cpspec 매개 변수는 배열에 설정된 속성 수를 지정합니다. 호출자는 특정 순서로 이러한 PROPVARIANT 구조체 값을 초기화할 필요가 없습니다. 그러나 구현은 반환 시 모든 멤버를 올바르게 채워야 합니다. 다른 적절한 값이 없는 경우 구현은 각 PROPVARIANT 구조체의 vt 멤버를 VT_EMPTY 설정해야 합니다.

반환 값

이 메서드는 E_UNEXPECTED 표준 반환 값과 다음을 지원합니다.

이 함수는 HRESULT 데이터 형식으로 래핑된 파일 시스템 오류 또는 Win32 오류를 반환할 수도 있습니다. 자세한 내용은 오류 처리 전략을 참조하세요.

자세한 내용은 속성 스토리지 고려 사항을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	propidlbase.h(Objbase.h, Propidlbase.h 포함)
라이브러리	Uuid.lib
DLL	Ole32.dll