IPortableDeviceValues::GetValue 메서드(portabledevicetypes.h)

GetValue 인터페이스는 키로 지정된 PROPVARIANT 값을 검색합니다.

구문

HRESULT GetValue(
  [in]  REFPROPERTYKEY key,
  [out] PROPVARIANT    *pValue
);

매개 변수

[in] key

검색할 항목을 지정하는 REFPROPERTYKEY 키입니다.

[out] pValue

검색된 PROPVARIANT 값에 대한 포인터입니다. 호출자가 호출이 완료되면 PropVariantClear 를 호출하여 메모리를 해제해야 합니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 반환 값은 다음 표에 나와 있습니다.

반환 코드	Description
S_OK	메서드가 성공했습니다.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	키로 지정된 속성이 컬렉션에 없습니다.

설명

이 메서드는 컬렉션에서 모든 형식의 값을 검색하는 데 사용할 수 있습니다. 그러나 값 형식을 미리 알고 있는 경우 추가 형식 검사를 위해 이 인터페이스의 특수 검색 방법 중 하나를 사용합니다.

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

요구 사항

요구 사항	값
대상 플랫폼	Windows
헤더	portabledevicetypes.h

추가 정보

IPortableDeviceValues 인터페이스

IPortableDeviceValues::RemoveValue

IPortableDeviceValues::SetValue