InitPropVariantFromPropVariantVectorElem 함수(propvarutil.h)

지정된 PROPVARIANT 벡터 요소를 기반으로 PROPVARIANT 구조를 초기화합니다.

구문

PSSTDAPI InitPropVariantFromPropVariantVectorElem(
  [in]  REFPROPVARIANT propvarIn,
  [in]  ULONG          iElem,
  [out] PROPVARIANT    *ppropvar
);

매개 변수

[in] propvarIn

형식: REFPROPVARIANT

원본 PROPVARIANT 구조체입니다 .

[in] iElem

형식: ULONG

원본 PROPVARIANT 구조 요소의 인덱스입니다.

[out] ppropvar

형식: PROPVARIANT*

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

반환 값

형식: HRESULT

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

설명

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

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

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

원본 PROPVARIANT 가 벡터 또는 배열인 경우 iElem 은 벡터 또는 배열의 요소 수보다 작아야 합니다.

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

소스 PROPVARIANT 가 비어 있으면 이 함수는 항상 오류 코드를 반환합니다.

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

예제

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

// PROPVARIANT propvar;
// Assume propvar is initialized and valid.
UINT cElem = PropVariantGetElementCount(propvar);
HRESULT hr = <mark type="const">S_OK</mark>;

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

    hr = InitPropVariantFromPropVariantVectorElem(propvar, iElem, &propvarElem);

    if (SUCCEEDED(hr))
    {
        // propvarElem is now valid.

        PropVariantClear(&propvarElem);
    }
}

요구 사항

추가 정보

PropVariantGetElem