funzione CM_Get_Next_Res_Des (cfgmgr32.h)

Articolo
08/22/2023

La funzione CM_Get_Next_Res_Des ottiene un handle al descrittore di risorse successivo, di un tipo di risorsa specificato, per una configurazione logica nel computer locale.

Sintassi

CMAPI CONFIGRET CM_Get_Next_Res_Des(
  [out]           PRES_DES    prdResDes,
  [in]            RES_DES     rdResDes,
  [in]            RESOURCEID  ForResource,
  [out, optional] PRESOURCEID pResourceID,
  [in]            ULONG       ulFlags
);

Parametri

[out] prdResDes

Puntatore a una posizione per ricevere un handle descrittore di risorse.

[in] rdResDes

Handle fornito dal chiamante a un descrittore di risorse o a una configurazione logica. Per altre informazioni, vedere la sezione Osservazioni seguenti.

[in] ForResource

Identificatore del tipo di risorsa fornito dal chiamante, che indica il tipo di descrittore di risorsa richiesto. Questa deve essere una delle costanti con prefisso ResType_ definite in Cfgmgr32.h.

[out, optional] pResourceID

Puntatore a un percorso per ricevere un identificatore di tipo di risorsa, se ForResource specifica ResType_All. Per qualsiasi altro valore ForResource , i chiamanti devono impostare questo valore su NULL.

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

Per enumerare i descrittori di risorse di una configurazione logica, iniziare chiamando CM_Get_Next_Res_Des con l'handle della configurazione logica come argomento per rdResDes. In questo modo viene ottenuto un handle per il primo descrittore di risorsa del tipo specificato da ForResource. Quindi per ogni chiamata successiva a CM_Get_Next_Res_Des, specificare l'handle descrittore ottenuto più di recente come argomento per rdResDes. Ripetere fino a quando la funzione restituisce CR_NO_MORE_RES_DES.

Per recuperare le informazioni archiviate in un descrittore di risorse, chiamare CM_Get_Res_Des_Data.

Per modificare le informazioni archiviate in un descrittore di risorse, chiamare CM_Modify_Res_Des.

I chiamanti di CM_Get_Next_Res_Des devono chiamare CM_Free_Res_Des_Handle per deallocare l'handle del descrittore di risorse, dopo che non è più necessario.

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_Next_Res_Des_Ex

Condividi tramite