InitPropVariantVectorFromPropVariant 함수(propvarutil.h)

다른 PROPVARIANT에 저장된 값을 사용하여 PROPVARIANT 구조체에서 벡터 요소를 초기화합니다.

구문

PSSTDAPI InitPropVariantVectorFromPropVariant(
  [in]  REFPROPVARIANT propvarSingle,
  [out] PROPVARIANT    *ppropvarVector
);

매개 변수

[in] propvarSingle

형식: REFPROPVARIANT

단일 값을 포함하는 원본 PROPVARIANT 구조체에 대한 참조입니다.

[out] ppropvarVector

형식: PROPVARIANT*

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

반환 값

형식: HRESULT

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

설명

이 함수는 단일 값을 포함하는 PROPVARIANT 구조를 벡터 값으로 변환하는 데 사용됩니다.

단순 소스 형식의 경우 이 함수는 PROPVARIANT 를 하나의 요소의 벡터로 초기화합니다.

문자열이 포함된 원본의 경우 이 함수는 소스 문자열에서 가져온 0개 이상의 부분 문자열을 사용하여 PROPVARIANT 를 초기화하고 세미콜론을 구분 기호로 처리합니다. 자세한 내용은 InitPropVariantFromStringAsVector 를 참조하세요.

다음 입력 유형이 지원됩니다.

• VT_I2
• VT_UI2
• VT_I4
• VT_UI4
• VT_I8
• VT_UI8
• VT_R8
• VT_BOOL
• VT_DATE
• VT_FILETIME
• VT_BSTR
• VT_LPWSTR

예제

더 큰 프로그램의 일부로 포함할 다음 예제에서는 InitPropVariantVectorFromPropVariant를 사용하는 방법을 보여 줍니다.

// PROPVARIANT propvarSource;
// Assume propvarSource is initialized and valid.

if (PropVariantGetElementCount(propvarSource) == 1)
{
    PROPVARIANT propvar;

    HRESULT hr = InitPropVariantVectorFromPropVariant(propvarSource, &propvar);

    if (SUCCEEDED(hr))
    {
       // propvar now is valid and is either VT_EMPTY or contains a vector.
       PropVariantClear(&propvar);
    }

요구 사항

추가 정보

InitPropVariantFromStringAsVector

PropVariantGetElem

PropVariantGetElementCount