IPortableDevicePropVariantCollection::Add 메서드

Add 메서드는 컬렉션에 항목을 추가합니다.

구문

HRESULT Add(
  [in] const PROPVARIANT *pValue
);

매개 변수

pValue [in]

컬렉션에 추가할 새 PROPVARIANT 개체에 대한 포인터입니다. 이 메서드는 PROPVARIANT 를 컬렉션에 복사하므로 이 메서드를 호출한 후 PropVariantClear 를 호출하여 변수의 로컬 복사본을 해제해야 합니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드	설명
S_OK	메서드가 성공했습니다.

설명

pValue용 VARTYPE이 VT_VECTOR 또는 VT_UI1 경우 NULL 또는 0 크기의 버퍼 설정 및 검색은 지원되지 않습니다. 예를 들어 pValue.caub.pElems = NULL 또는 pValue.caub.cElems = 0은 허용되지 않습니다.

호출자가 컬렉션에 포함된 다른 VARTYPE의 항목을 추가하려고 하고 이 인터페이스에서 PROPVARIANT 값을 자동으로 변경할 수 없는 경우 이 메서드는 실패합니다. 컬렉션 형식을 수동으로 변경하려면 IPortableDevicePropVariantCollection::ChangeType을 호출합니다.

예

이 메서드를 사용하는 방법에 대한 예제는 영구 고유 식별자에서 개체 식별자 검색을 참조하세요.

요구 사항

요구 사항	값
헤더	PortableDeviceTypes.h
라이브러리	PortableDeviceGUIDs.lib

참조

IPortableDevicePropVariantCollection 인터페이스

디바이스에서 콘텐츠 이동

영구 고유 식별자에서 개체 식별자 검색