PropVariantClear 함수(combaseapi.h)

PropVariantClear 함수는 지정된 PROPVARIANT 구조에서 해제할 수 있는 모든 요소를 해제합니다. 알려진 요소 포인터가 있는 복합 요소의 경우 포함 요소를 해제하기 전에 기본 요소가 해제됩니다.

구문

HRESULT PropVariantClear(
  [in] PROPVARIANT *pvar
);

매개 변수

[in] pvar

할당 취소할 수 있는 요소를 해제할 초기화된 PROPVARIANT 구조체에 대한 포인터입니다. 반환할 때 모든 0은 PROPVARIANT 구조에 기록됩니다.

반환 값

이 함수는 HRESULT를 반환합니다.

설명

모든 수준의 간접 참조에서 NULL 포인터는 무시됩니다. 예를 들어 pvar 매개 변수는 VT_CF 형식의 PROPVARIANT 구조를 가리킵니다. PROPVARIANT 구조체의 pclipdata 멤버는 CLIPDATA 구조를 가리킵니다. CLIPDATA 구조체의 pClipData 포인터는 NULL입니다. 이 예제에서는 pClipData 포인터가 무시됩니다. 그러나 PROPVARIANT 구조체의 pclipdata 멤버가 가리키는 CLIPDATA 구조체가 해제됩니다.

반환할 때 이 함수는 지정된 PROPVARIANT 구조체에 0을 기록하므로 VT 형식은 VT_EMPTY.

NULL을 pvar 매개 변수로 전달하면 반환 코드가 S_OK 생성됩니다.

참고 이 함수를 사용하여 PROPVARIANT 구조를 초기화하지 마세요. 대신 PropVariantInit 매크로(Propidl.h에 정의됨)를 사용하여 이러한 구조를 초기화합니다.

 

요구 사항

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

추가 정보

FreePropVariantArray