funzione CM_Get_DevNode_Registry_PropertyW (cfgmgr32.h)
La funzione CM_Get_DevNode_Registry_Property recupera una proprietà del dispositivo specificata dal Registro di sistema.
Sintassi
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
);
Parametri
[in] dnDevInst
Handle di istanza del dispositivo fornito dal chiamante associato al computer locale.
[in] ulProperty
Valore costante CM_DRP_ prefisso che identifica la proprietà del dispositivo da ottenere dal Registro di sistema. Queste costanti sono definite in Cfgmgr32.h.
[out, optional] pulRegDataType
Facoltativo, può essere NULL. Puntatore a un percorso che riceve il tipo di dati del Registro di sistema, specificato come costante con prefisso REG_ definito in Winnt.h.
[out, optional] Buffer
Facoltativo, può essere NULL. Puntatore a un buffer fornito dal chiamante che riceve la proprietà del dispositivo richiesto. Se questo valore è NULL, la funzione fornisce solo la lunghezza dei dati richiesti nell'indirizzo a cui punta pulLength.
[in, out] pulLength
Puntatore a una variabile ULONG in cui la funzione archivia la lunghezza, in byte, della proprietà del dispositivo richiesta.
Se il parametro Buffer è impostato su NULL, la variabile ULONG deve essere impostata su zero.
Se il parametro Buffer non è impostato su NULL, la variabile ULONG deve essere impostata sulla lunghezza, in byte, del buffer fornito dal chiamante.
[in] ulFlags
Non usato, deve essere zero.
Valore restituito
Se l'operazione ha esito positivo, la funzione restituisce CR_SUCCESS. In caso contrario, restituisce uno dei codici di errore con prefisso CR_ definiti in Cfgmgr32.h.
Commenti
Per informazioni su come usare handle di istanza del dispositivo associati al computer locale, vedere CM_Get_Child.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile a partire da Microsoft Windows 2000. |
| Piattaforma di destinazione | Universale |
| Intestazione | cfgmgr32.h (include Cfgmgr32.h) |
| Libreria | Cfgmgr32.lib |