IPortableDeviceValues::GetValue 메서드
GetValue 메서드는 키로 지정된 PROPVARIANT 값을 검색합니다.
구문
HRESULT GetValue(
[in] REFPROPERTYKEY key,
[out] PROPVARIANT *pValue
);
매개 변수
-
키 [in]
-
검색할 항목을 지정하는 REFPROPERTYKEY 키입니다.
-
pValue [out]
-
검색된 PROPVARIANT 값에 대한 포인터입니다. 호출자는 작업을 완료할 때 PropVariantClear 를 호출하여 메모리를 해제해야 합니다.
반환 값
이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.
반환 코드 | Description |
---|---|
|
메서드가 성공했습니다. |
|
키로 지정된 속성이 컬렉션에 없습니다. |
설명
pValue에 대한 VARTYPE이 VT_VECTOR 또는 VT_UI1 경우 NULL 또는 0 크기 버퍼 검색은 지원되지 않습니다. 예를 들어 pValue.caub.pElems = NULL 또는 pValue.caub.cElems = 0은 허용되지 않습니다.
이 메서드는 컬렉션에서 모든 형식의 값을 검색하는 데 사용할 수 있습니다. 그러나 값 형식을 미리 알고 있는 경우 이 인터페이스의 특수 검색 방법 중 하나를 사용하여 PROPVARIANT 값을 직접 사용하는 오버헤드를 방지합니다.
요구 사항
요구 사항 | 값 |
---|---|
헤더 |
|
라이브러리 |
|
추가 정보
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기