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 형식을 보여 줍니다.

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