funzione CM_Get_Res_Des_Data_Size (cfgmgr32.h)

Articolo
03/05/2024

La funzione CM_Get_Res_Des_Data_Size ottiene le dimensioni del buffer necessarie per contenere le informazioni contenute in un descrittore di risorse specificato nel computer locale.

Sintassi

CMAPI CONFIGRET CM_Get_Res_Des_Data_Size(
  [out] PULONG  pulSize,
  [in]  RES_DES rdResDes,
  [in]  ULONG   ulFlags
);

Parametri

[out] pulSize

Indirizzo fornito dal chiamante di una posizione per ricevere le dimensioni del buffer necessarie.

[in] rdResDes

Handle fornito dal chiamante a un descrittore di risorse, ottenuto da una chiamata precedente a CM_Get_Next_Res_Des.

[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.

Nota A partire da Windows 8, CM_Get_Res_Des_Data_Size restituisce CR_CALL_NOT_IMPLEMENTED se usato in uno scenario Wow64. Per richiedere informazioni sulle risorse hardware in un computer locale, è necessario implementare una versione nativa dell'architettura dell'applicazione usando le API delle risorse hardware. Ad esempio: un'applicazione AMD64 per sistemi AMD64.

Commenti

Il valore delle dimensioni restituite rappresenta le dimensioni della struttura di risorse appropriata (vedere CM_Add_Res_Des). Se il descrittore di risorse risiede in un elenco dei requisiti delle risorse, le dimensioni restituite includono sia le dimensioni della struttura delle risorse che lo spazio allocato per le matrici di intervalli associate.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Microsoft Windows 2000 e versioni successive di Windows.
Piattaforma di destinazione	Desktop
Intestazione	cfgmgr32.h (include Cfgmgr32.h)
Libreria	Cfgmgr32.lib
DLL	Cfgmgr32.dll

Vedi anche

CM_Get_Res_Des_Data_Size_Ex

Condividi tramite