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 |