funzione CM_Get_DevNode_Registry_PropertyA (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_PropertyA(
  [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 dell'istanza del dispositivo fornita dal chiamante associato al computer locale.

[in] ulProperty

Valore costante con prefisso CM_DRP_ 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 richiesta. 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, espressa 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 gli handle di istanza del dispositivo associati al computer locale, vedere CM_Get_Child.

Requisiti

Vedi anche

CM_Get_Child
CM_Set_DevNode_Registry_Property
SetupDiGetDeviceRegistryProperty