funzione CM_Free_Res_Des (cfgmgr32.h)

Articolo
02/23/2024

La funzione CM_Free_Res_Des rimuove un descrittore di risorse da una configurazione logica nel computer locale.

Sintassi

CMAPI CONFIGRET CM_Free_Res_Des(
  [out] PRES_DES prdResDes,
  [in]  RES_DES  rdResDes,
  [in]  ULONG    ulFlags
);

Parametri

[out] prdResDes

Posizione fornita dal chiamante per ricevere un handle per il descrittore di risorse precedente della configurazione. Questo parametro può essere NULL. Per altre informazioni, vedere la sezione Osservazioni seguente.

[in] rdResDes

Handle fornito dal chiamante al descrittore di risorse da rimuovere. Questo handle deve essere stato ottenuto in precedenza chiamando una delle funzioni seguenti:

CM_Add_Res_Des

CM_Add_Res_Des_Ex

CM_Get_Next_Res_Des

CM_Get_Next_Res_Des_Ex

CM_Modify_Res_Des

CM_Modify_Res_Des_Ex

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

I descrittori di risorse per ogni configurazione vengono archiviati in una matrice. Se si specifica un indirizzo per prdResDes, CM_Free_Res_Des restituisce un handle al descrittore di risorsa precedente, nella matrice, a quello rimosso. Se l'handle specificato da rdResDes rappresenta il descrittore di risorse che si trova per primo nella matrice, prdResDes riceve un handle per la configurazione logica.

Si noti che la chiamata CM_Free_Res_Des libera il descrittore di risorse, ma non l'handle del descrittore. Per liberare l'handle, chiamare CM_Free_Res_Des_Handle.

I chiamanti di questa funzione devono avere SeLoadDriverPrivilege. I privilegi sono descritti nella documentazione di Microsoft Windows SDK.

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_Free_Res_Des_Ex

Condividi tramite