CM_Get_DevNode_Registry_PropertyW-Funktion (cfgmgr32.h)
Die CM_Get_DevNode_Registry_Property-Funktion ruft eine angegebene Geräteeigenschaft aus der Registrierung ab.
Syntax
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
);
Parameter
[in] dnDevInst
Ein vom Anrufer bereitgestelltes Gerät instance Handle, das an den lokalen Computer gebunden ist.
[in] ulProperty
Ein CM_DRP_-Präfixkonstantenwert, der die Geräteeigenschaft identifiziert, die aus der Registrierung abgerufen werden soll. Diese Konstanten werden 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, gibt die Funktion nur die Länge der angeforderten Daten in der Adresse an, auf die von pulLength verwiesen wird.
[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ätehandles instance, 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 (einschließlich Cfgmgr32.h) |
| Bibliothek | Cfgmgr32.lib |