CM_Get_DevNode_PropertyW函式 (cfgmgr32.h)
CM_Get_DevNode_Property函式會擷取裝置實例屬性。
語法
CMAPI CONFIGRET CM_Get_DevNode_PropertyW(
[in] DEVINST dnDevInst,
[in] const DEVPROPKEY *PropertyKey,
[out] DEVPROPTYPE *PropertyType,
[out] PBYTE PropertyBuffer,
[in, out] PULONG PropertyBufferSize,
[in] ULONG ulFlags
);
參數
[in] dnDevInst
系結至本機電腦的裝置實例控制碼。
[in] PropertyKey
DEVPROPKEY結構的指標，表示所要求裝置實例屬性的裝置屬性索引鍵。
[out] PropertyType
接收所要求裝置實例屬性之 property-data-type 識別碼之 DEVPROPTYPE型別變數的指標，其中 property-data-type 識別碼是基底資料類型識別碼之間的位 OR，如果修改基底資料類型，則為 property-data-type 修飾詞。
[out] PropertyBuffer
接收要求之裝置實例屬性之緩衝區的指標。 只有在 緩衝區夠大，足以保存所有屬性值資料時，CM_Get_DevNode_Property才會擷取要求的屬性。 指標可以是 Null。
[in, out] PropertyBufferSize
PropertyBuffer緩衝區的大小，以位元組為單位。 如果 PropertyBuffer 設定為 Null， 則必須將 *PropertyBufferSize 設定為零。 做為輸出，如果緩衝區不夠大，無法保存所有屬性值資料， CM_Get_DevNode_Property 會傳回 *PropertyBufferSize中的資料大小，以位元組為單位。
[in] ulFlags
保留的。 必須設定為零。
傳回值
如果作業成功，函式會傳回CR_SUCCESS。 否則，它會傳回 Cfgmgr32.h中定義的其中一個CR_前置錯誤碼。
備註
CM_Get_DevNode_Property 是 整合裝置屬性模型的一部分。
規格需求
| 最低支援的用戶端 | 可在 Microsoft Windows Vista 和更新版本的 Windows 中使用。 |
| 目標平台 | Universal |
| 標頭 | cfgmgr32.h (包含 Cfgmgr32.h) |
| 程式庫 | Cfgmgr32.lib |
| Dll | CfgMgr32.dll |