CM_Get_DevNode_Registry_PropertyA-Funktion (cfgmgr32.h)

Artikel
02/23/2024

Die CM_Get_DevNode_Registry_Property-Funktion ruft eine angegebene Geräteeigenschaft aus der Registrierung ab.

Syntax

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
);

Parameter

[in] dnDevInst

Ein vom Aufrufer bereitgestelltes Gerät instance Handle, das an den lokalen Computer gebunden ist.

[in] ulProperty

Ein CM_DRP_ konstanter Wert, der die Geräteeigenschaft identifiziert, die aus der Registrierung abgerufen werden soll. Diese Konstanten sind in Cfgmgr32.h definiert.

[out, optional] pulRegDataType

Optional, kann NULL sein. Ein Zeiger auf einen Speicherort, der den Registrierungsdatentyp empfängt, der als REG_-Präfixkonstante angegeben ist, die in Winnt.h definiert ist.

[out, optional] Buffer

Optional, kann NULL sein. Ein Zeiger auf einen vom Aufrufer bereitgestellten Puffer, der die angeforderte Geräteeigenschaft empfängt. Wenn dieser Wert NULL ist, stellt die Funktion nur die Länge der angeforderten Daten in der Adresse bereit, auf die pulLength verweist.

[in, out] pulLength

Ein Zeiger auf eine ULONG-Variable, in der die Funktion die Länge der angeforderten Geräteeigenschaft in Bytes speichert.

Wenn der Buffer-Parameter auf NULL festgelegt ist, muss die ULONG-Variable auf 0 festgelegt werden.

Wenn der Buffer-Parameter nicht auf NULL festgelegt ist, muss die ULONG-Variable auf die Länge (in Bytes) des vom Aufrufer bereitgestellten Puffers festgelegt werden.

[in] ulFlags

Nicht verwendet, muss null sein.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion CR_SUCCESS zurück. Andernfalls wird einer der CR_-Präfix-Fehlercodes zurückgegeben, die in Cfgmgr32.h definiert sind.

Hinweise

Informationen zur Verwendung von Geräte- instance Handles, die an den lokalen Computer gebunden sind, finden Sie unter CM_Get_Child.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Microsoft Windows 2000.
Zielplattform	Universell
Header	cfgmgr32.h (include Cfgmgr32.h)
Bibliothek	Cfgmgr32.lib

Weitere Informationen

CM_Get_Child
CM_Set_DevNode_Registry_Property
SetupDiGetDeviceRegistryProperty

Freigeben über