IPropertyStorage::ReadPropertyNames 메서드(propidl.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 |
| 헤더 | propidl.h(Objbase.h, Propidlbase.h 포함) |
| 라이브러리 | Uuid.lib |
| DLL | Ole32.dll |