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 |