CM_Get_DevNode_Registry_PropertyA函式 (cfgmgr32.h)

CM_Get_DevNode_Registry_Property函式會從登錄擷取指定的裝置屬性。

語法

CMAPI CONFIGRET CM_Get_DevNode_Registry_PropertyA(
  [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。

規格需求

另請參閱

CM_Get_Child
CM_Set_DevNode_Registry_Property
SetupDiGetDeviceRegistryProperty