IWDFNamedPropertyStore::GetNamedValue 메서드(wudfddi.h)

[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에 새 기능이 추가되지 않으며 최신 버전의 Windows 10 UMDF 1에 대한 지원이 제한됩니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF를 사용하여 시작 참조하세요.]

GetNamedValue 메서드는 속성 값을 검색합니다.

구문

HRESULT GetNamedValue(
  [in]  LPCWSTR     pszName,
  [out] PROPVARIANT *pv
);

매개 변수

[in] pszName

속성의 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다.

[out] pv

속성의 값을 받는 변수에 대한 포인터입니다.

반환 값

GetNamedValue는 작업이 성공하면 S_OK 반환합니다. 그렇지 않으면 이 메서드는 Winerror.h에 정의된 오류 코드 중 하나를 반환합니다.

설명

GetNamedValue 메서드는 pv 매개 변수가 가리키는 PROPVARIANT 구조의 문자열에 대한 메모리를 할당합니다. 호출자는 다음 코드 조각과 같이 PropVariantClear 함수를 호출하여 이 메모리를 해제해야 합니다.

hr = pPropStore->GetNamedValue(L"Host", &val);
...
PropVariantClear(&val);

호출자가 메모리를 해제하지 않으면 메모리 누수로 인해 발생할 수 있습니다.

속성 값에 대해 지원되는 변형 형식은 다음과 같습니다. 다음 표에서는 원래 변형 형식에 관계없이 반환되는 변형 형식을 보여 줍니다.

Variant 형식	검색된 변형 유형
VT_BSTR	클라이언트가 문자열 값을 읽는 동안 값은 값을 작성하는 데 사용된 원래 변형 형식에 관계없이 VT_LPWSTR 반환됩니다.
VT_LPWSTR
VT_LPSTR
VT_I1	클라이언트가 정수 값을 읽는 동안 값을 작성하는 데 사용된 원래 변형 형식에 관계없이 값이 VT_UI4 반환됩니다.
VT_UI1
VT_I2
VT_UI2
VT_I4
VT_UI4
VT_UINT
VT_BLOB	이진 값은 VT_BLOB 반환됩니다.
VT_VECTOR | VT_LPWSTR	문자열 배열은 VT_VECTOR | 로 반환됩니다. VT_LPWSTR

 

환경 변수를 포함하는 문자열은 읽기 시 확장됩니다.

자세한 내용은 UMDF 기반 드라이버에서 레지스트리 사용을 참조하세요.

요구 사항

요구 사항	값
지원 종료	UMDF 2.0 이상에서는 사용할 수 없습니다.
대상 플랫폼	데스크톱
최소 UMDF 버전	1.5
머리글	wudfddi.h(Wudfddi.h 포함)
DLL	WUDFx.dll

추가 정보

IWDFNamedPropertyStore

PROPVARIANT

PropVariantClear