FreePropVariantArray 함수(combaseapi.h)
FreePropVariantArray 함수는 rgvars 배열의 각 PROPVARIANT 구조체에서 PropVariantClear를 호출하여 배열의 각 멤버에 대해 값을 0으로 만듭니다.
구문
HRESULT FreePropVariantArray(
[in] ULONG cVariants,
[in] PROPVARIANT *rgvars
);
매개 변수
[in] cVariants
PROPVARIANT 배열(rgvars)의 요소 수입니다.
[in] rgvars
할당 취소할 수 있는 요소를 해제할 PROPVARIANT 구조체의 초기화된 배열에 대한 포인터입니다. 종료할 때 모든 0은 PROPVARIANT 구조체에 기록됩니다(따라서 태그를 VT_EMPTY).
반환 값
이 함수는 HRESULT를 반환합니다.
설명
FreePropVariantArray는 PROPVARIANT 구조체 배열에서 PropVariantClear를 호출하여 유효한 모든 멤버를 지웁 수 있습니다. 유효한 모든 PROPVARIANT 구조가 해제됩니다. PROPVARIANT 구조체에 잘못된 VT 형식이 포함된 경우 유효한 멤버가 해제되고 함수가 STG_E_INVALIDPARAMETER 반환합니다.
rgvars에 NULL을 전달하는 것은 합법적이며 S_OK 반환 코드를 생성합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | combaseapi.h |
| 라이브러리 | Ole32.lib |
| DLL | Ole32.dll |