共用方式為

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 方法會配置 PROPVARIANT 結構中由 pv 參數所指向之字串串的記憶體。 呼叫端接著必須藉由呼叫 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