funzione CM_Get_Res_Des_Data (cfgmgr32.h)

Articolo
02/23/2024

La funzione CM_Get_Res_Des_Data recupera le informazioni archiviate in un descrittore di risorse nel computer locale.

Sintassi

CMAPI CONFIGRET CM_Get_Res_Des_Data(
  [in]  RES_DES rdResDes,
  [out] PVOID   Buffer,
  [in]  ULONG   BufferLen,
  [in]  ULONG   ulFlags
);

Parametri

[in] rdResDes

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

[out] Buffer

Indirizzo di un buffer per ricevere il contenuto di un descrittore di risorse. Le dimensioni del buffer necessarie devono essere ottenute chiamando CM_Get_Res_Des_Data_Size.

[in] BufferLen

Lunghezza fornita dal chiamante del buffer specificato da Buffer.

[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 restituisce CR_CALL_NOT_IMPLEMENTED quando viene 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

Le informazioni restituite nel buffer fornito da Buffer verranno formattate come una delle strutture del tipo di risorsa elencate nella descrizione di CM_Add_Res_Des, in base al tipo di risorsa specificato quando CM_Get_Next_Res_Des è stato chiamato per ottenere l'handle del descrittore di risorse.

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_Ex

Condividi tramite