VariantClear 함수(oleauto.h)
변형을 지웁니다.
구문
HRESULT VariantClear(
[in, out] VARIANTARG *pvarg
);
매개 변수
[in, out] pvarg
지울 변형입니다.
반환 값
이 함수는 이러한 값 중 하나를 반환할 수 있습니다.
| 반환 코드 | Description |
|---|---|
|
성공. |
|
변형에는 잠긴 배열이 포함되어 있습니다. |
|
변형 형식이 유효한 형식이 아닙니다. |
|
인수 중 하나가 잘못되었습니다. |
설명
이 함수를 사용하여 VARIANTARG를 포함하는 메모리가 해제되기 전에 VARIANTARG(또는 VARIANT) 형식의 변수를 지웁니다(지역 변수가 scope 꺼지는 경우).
함수는 vt 필드를 VT_EMPTY 설정하여 VARIANTARG를 지웁니다. VARIANTARG의 현재 콘텐츠가 먼저 릴리스됩니다. vtfield가 VT_BSTR 경우 문자열이 해제됩니다. vtfield가 VT_DISPATCH 경우 개체가 해제됩니다. vt 필드에 VT_ARRAY 비트 집합이 있으면 배열이 해제됩니다.
지울 변형이 참조로 전달되는 COM 개체인 경우 pvargparameter의 vtfield는 | VT_DISPATCH. VT_BYREF 또는 VT_UNKNOWN | VT_BYREF. 이 경우 VariantClear 는 개체를 해제하지 않습니다. 지워지는 변형은 개체에 대한 참조에 대한 포인터이므로 VariantClear 는 개체를 해제해야 하는지 확인할 방법이 없습니다. 따라서 호출자는 개체를 적절하게 해제해야 합니다.
경우에 따라 VariantClear를 호출하지 않고 코드에서 변형을 지우는 것이 좋습니다. 예를 들어 이 함수를 호출하지 않고 VT_I4 변형의 형식을 다른 형식으로 변경할 수 있습니다. BSTR의 Safearrays에는 VariantClear가 아닌 각 요소에 대해 SysFreeString이 호출됩니다. 그러나 VT_type 수신되었지만 처리할 수 없는 경우 VariantClear 를 호출해야 합니다. 또한 variant의 Safearray에는 각 멤버에 대해 VariantClear 가 호출됩니다. 이러한 경우 VariantClear 를 사용하면 Automation에서 나중에 새 변형 형식을 추가하는 경우 코드가 계속 작동합니다.
초기화되지 않은 변형에는 VariantClear 를 사용하지 마세요. VariantInit 를 사용하여 새 VARIANTARG 또는 VARIANT를 초기화합니다.
미해결 참조가 있는 배열을 포함하는 변형은 지울 수 없습니다. 이렇게 하면 DISP_E_ARRAYISLOCKED 포함하는 HRESULT가 반환됩니다.
예제
다음 예제에서는 변형 배열을 지우는 방법을 보여 줍니다. 여기서 celt 는 배열의 요소 수입니다.
for(int i = 0; i < celt; ++i)
VariantClear(&rgvar[i]);
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | oleauto.h |
| 라이브러리 | OleAut32.lib |
| DLL | OleAut32.dll |