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

  • 아티클

ReadPropertyNames 메서드는 지정된 속성 ID에 대한 기존 문자열 이름을 검색합니다.

구문

HRESULT ReadPropertyNames(
  [in]      ULONG           cpropid,
  [in]      const PROPID [] rgpropid,
  [in, out] LPOLESTR []     rglpwstrName
);

매개 변수

[in] cpropid

배열 rgpropid의 입력에 있는 요소 수입니다. 이 매개 변수의 값은 0으로 설정할 수 있지만 속성 이름을 읽지 못하므로 이 메서드의 용도를 무효화합니다.

[in] rgpropid

이름을 검색할 속성 ID의 배열입니다.

[in, out] rglpwstrName

LPWSTR 멤버의 cpropid 크기의 호출자가 할당한 배열입니다. 반환할 때 구현은 이 배열을 채웁니다. 지정된 항목에는 속성 ID의 해당 문자열 이름이 포함되거나 속성 ID에 문자열 이름이 없는 경우 비어 있을 수 있습니다.

배열의 각 LPWSTR 멤버는 CoTaskMemFree 함수를 사용하여 해제해야 합니다.

반환 값

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

설명

rgpropid 배열에 제공된 속성 ID 목록의 각 속성 ID에 대해 ReadPropertyNames는 문자열 이름이 있는 경우 해당 문자열 이름을 검색합니다. 문자열 이름은 속성을 만들 때 IPropertyStorage::WriteMultiple 호출에서 이름을 지정하거나 IPropertyStorage::WritePropertyNames 호출을 통해 만들어집니다. 두 경우 모두 문자열 이름은 선택 사항이지만 모든 속성에는 속성 ID가 있어야 합니다.

속성 ID에 매핑된 문자열 이름은 집합 내에서 고유해야 합니다.

요구 사항

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

추가 정보

IPropertyStorage

IPropertyStorage::WriteMultiple

IPropertyStorage::WritePropertyNames