CM_Get_DevNode_Registry_PropertyW函式 (cfgmgr32.h)
CM_Get_DevNode_Registry_Property函式會從登錄擷取指定的裝置屬性。
語法
CMAPI CONFIGRET CM_Get_DevNode_Registry_PropertyW(
[in] DEVINST dnDevInst,
[in] ULONG ulProperty,
[out, optional] PULONG pulRegDataType,
[out, optional] PVOID Buffer,
[in, out] PULONG pulLength,
[in] ULONG ulFlags
);
參數
[in] dnDevInst
系結至本機計算機的呼叫端提供的裝置實例句柄。
[in] ulProperty
CM_DRP_前置常數值,可識別要從登錄取得的裝置屬性。 這些常數定義於 Cfgmgr32.h 中。
[out, optional] pulRegDataType
選擇性,可以是 NULL。 接收登錄數據類型的位置指標,指定為 Winnt.h 中定義的REG_前置常數。
[out, optional] Buffer
選擇性,可以是 NULL。 接收要求之裝置屬性之呼叫端所提供緩衝區的指標。 如果此值為 NULL,此函式只會提供 pulLength 所指向之位址中要求數據的長度。
[in, out] pulLength
ULONG 變數的指標,函式會儲存所要求裝置屬性的長度,以位元組為單位。
如果 Buffer 參數設定為 NULL,ULONG 變數必須設定為零。
如果 Buffer 參數未設定為 NULL,則 ULONG 變數必須設定為呼叫端所提供緩衝區的長度,以位元組為單位。
[in] ulFlags
未使用,必須是零。
傳回值
如果作業成功,函式會傳回CR_SUCCESS。 否則,它會傳回 Cfgmgr32.h 中定義的其中一個CR_前置錯誤碼。
備註
如需如何使用系結至本機計算機的裝置實例句柄的詳細資訊,請參閱 CM_Get_Child。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 從 Microsoft Windows 2000 開始提供。 |
目標平台 | Universal |
標頭 | cfgmgr32.h (包含 Cfgmgr32.h) |
程式庫 | Cfgmgr32.lib |