다음을 통해 공유

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

추가 정보

PropVariantClear