InitVariantFromVariantArrayElem 함수(propvarutil.h)

다른 VARIANT 구조체에 저장된 값을 사용하여 VARIANT 구조를 초기화합니다.

구문

PSSTDAPI InitVariantFromVariantArrayElem(
  [in]  REFVARIANT varIn,
  [in]  ULONG      iElem,
  [out] VARIANT    *pvar
);

매개 변수

[in] varIn

형식: REFVARIANT

원본 VARIANT 구조체에 대한 참조입니다.

[in] iElem

형식: ULONG

원본 VARIANT 구조 요소 중 하나의 인덱 스 입니다.

[out] pvar

형식: VARIANT*

이 함수가 반환되면 초기화된 VARIANT 구조체가 포함됩니다.

반환 값

형식: HRESULT

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이 도우미 함수는 다음 형식의 VARIANT 구조에 대해 작동합니다.

• VT_BSTR
• VT_BOOL
• VT_I2
• VT_I4
• VT_I8
• VT_U12
• VT_U14
• VT_U18
• VT_DATE
• VT_ARRAY | (VT_BSTR, VT_BOOL, VT_I2, VT_I4, VT_I8, VT_U12, VT_U14, VT_U18, VT_DATE 중 하나)

이 함수는 원본 VARIANT 구조에서 단일 값을 추출하고 해당 값을 사용하여 출력 VARIANT 구조를 초기화합니다. 호출하는 애플리케이션은 더 이상 필요하지 않은 경우 pvar에서 참조하는 VARIANT를 해제하려면 VariantClear를 사용해야 합니다.

원본 VARIANT 가 배열인 경우 iElem 은 배열의 요소 수보다 작아야 합니다.

원본 VARIANT 에 단일 값이 있는 경우 iElem 은 0이어야 합니다.

원본 VARIANT 가 비어 있으면 이 함수는 항상 오류 코드를 반환합니다.

VariantGetElementCount를 사용하여 배열 또는 배열의 요소 수를 가져올 수 있습니다.

예제

더 큰 프로그램의 일부로 포함할 다음 예제에서는 반복 문 에서 InitVariantFromVariantArrayElem 을 사용하여 VARIANT의 값에 액세스하는 방법을 보여 줍니다.

// VARIANT var;
// Assume var is initialized and valid.
UINT cElem = VariantGetElementCount(var);
HRESULT hr = <mark type="const">S_OK</mark>;

for (UINT iElem = 0; SUCCEEDED(hr) && iElem < cElem; iElem ++)
{
    VARIANT varElem = {0};

    hr = InitVariantFromVariantArrayElem(var, iElem, &varElem);

    if (SUCCEEDED(hr))
    {
        // varElem is now valid.
        VariantClear(&varElem);
    }
}

요구 사항

추가 정보

InitPropVariantFromPropVariantVectorElem

VariantGetElem