IPropertySystem::GetPropertyDescriptionListFromString 메서드(propsys.h)

IPropertyDescriptionList를 구현하는 하위 시스템 개체의 instance 가져와서 제공된 문자열에 따라 속성 설명의 정렬된 컬렉션을 가져옵니다.

구문

HRESULT GetPropertyDescriptionListFromString(
  [in]  LPCWSTR pszPropList,
  [in]  REFIID  riid,
  [out] void    **ppv
);

[in] pszPropList

형식: LPCWSTR

속성 목록을 식별하는 문자열에 대한 포인터입니다.

[in] riid

형식: REFIID

원하는 IID에 대한 참조입니다.

[out] ppv

형식: void**

IPropertyDescriptionList 인터페이스 포인터의 주소입니다.

형식: HRESULT

다음 값 중 하나를 반환합니다.

반환 코드	Description
S_OK	인터페이스가 획득되었음을 나타냅니다.
E_INVALIDARG	ppv가 NULL임을 나타냅니다.

속성 설명 목록 문자열("proplist") 구문은 각 속성 이름과 연결된 플래그가 있는 정식 속성 이름 시퀀스로 구성됩니다. 문자열은 "prop:"로 시작합니다. 구문은 다음과 같습니다. prop:[flags]propertyname[endflags];

플래그는 선택 사항이며 아래 플래그 중 어느 것이든 될 수 있습니다. 참고: 이러한 플래그는 PROPDESC_VIEW_FLAGS 열거형으로 변환합니다.

플래그	의미
-	역순으로 정렬합니다(PDVF_REVERSESORT).
0	기본 목록과 보조 목록 모두에 기본적으로 표시(PDVF_SHOWBYDEFAULT \| PDVF_SHOWINPRIMARYLIST \| PDVF_SHOWINSECONDARYLIST).
1	기본 및 보조 목록에 표시(PDVF_SHOWINPRIMARYLIST \| PDVF_SHOWINSECONDARYLIST).
2	보조 목록에 표시(PDVF_SHOWINSECONDARYLIST).
^	새 그룹(PDVF_BEGINNEWGROUP)을 시작합니다.
/	오른쪽 맞춤(PDVF_RIGHTALIGN).
*	값이 없으면 숨깁니다.
\|	가운데 맞춤. (PDVF_CENTERALIGN).
~	레이블을 숨깁니다. (PDVF_HIDELABEL).
#	채우기 영역입니다. (PDVF_FILLAREA).
?	속성 처리기(PDVF_HIDEIFUNSUPPORTED)에서 지원되지 않는 경우 숨깁니다.
<	링크로 구문 분석(PDVF_PARSEASLINK).
&	전체 링크로 표시(PDVF_SHOWASWHOLELINK).

dbfolder 및 파일 폴더 관점에서:

0	defview, 열 선택기 메뉴 및 열 선택 대화 상자에 열로 표시합니다.
1	열 선택기 메뉴 및 대화 상자에 표시됩니다.
2	열 선택기 대화 상자에 표시됩니다.
NULL	검색 결과에 를 포함하지만 UI에 숨깁니다.

엔드플래그도 선택 사항이며 다음이 될 수 있습니다.

EndFlag	의미
]	끝 열(확장 타일 보기에 사용됨)

objbase.h에 정의된 IID_PPV_ARGS 매크로를 사용하여 riid 및 ppv 매개 변수를 패키지하는 것이 좋습니다. 이 매크로는 ppv의 값이 가리키는 인터페이스를 기반으로 올바른 IID를 제공하므로 코딩 오류가 발생할 가능성이 없습니다.

속성 스키마에 대한 자세한 내용은 속성 스키마를 참조하세요.


지원되는 최소 클라이언트	WINDOWS XP SP2, Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 SP1 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	propsys.h
DLL	Propsys.dll(버전 5.0 이상)
재배포 가능 파일	WDS(Windows 데스크톱 검색) 3.0