PropVariantToVariant 함수(propvarutil.h)

PROPVARIANT 구조체의 내용을 VARIANT 구조체로 변환합니다.

구문

PSSTDAPI PropVariantToVariant(
  [in]  const PROPVARIANT *pPropVar,
  [out] VARIANT           *pVar
);

[in] pPropVar

형식: const PROPVARIANT*

원본 PROPVARIANT 구조체에 대한 포인터입니다.

[out] pVar

형식: VARIANT*

VARIANT 구조체에 대한 포인터입니다. 이 함수가 반환되면 VARIANT 에는 변환된 정보가 포함됩니다.

형식: HRESULT

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

일반적으로 PROPVARIANT 에 저장된 데이터는 데이터 형식 변경 없이 VARIANT 에 복사됩니다. 그러나 다음 경우에는 데이터 형식에 대한 직접적인 VARIANT 지원이 없으며 표시된 대로 변환됩니다.

원래 PROPVARIANT 형식	VARIANT 형식으로 저장됨
VT_BLOB, VT_STREAM	VT_UNKNOWN. punkVal 멤버에는 원본 데이터가 포함된 IStream에 대한 포인터가 포함됩니다.
VT_LPSTR, VT_LPWSTR, VT_CLSID	VT_BSTR
VT_FILETIME	VT_DATE
VT_VECTOR\|x	VT_ARRAY\|y

다음 형식은 이 함수로 변환할 수 없습니다.

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