funzione CM_Free_Res_Des_Ex (cfgmgr32.h)

Articolo
02/26/2024

[A partire da Windows 8 e Windows Server 2012, questa funzione è stata deprecata. Usare invece CM_Free_Res_Des .]

La funzione CM_Free_Res_Des_Ex rimuove un descrittore di risorse da una configurazione logica in un computer locale o remoto.

Sintassi

CMAPI CONFIGRET CM_Free_Res_Des_Ex(
  [out]          PRES_DES prdResDes,
  [in]           RES_DES  rdResDes,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

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.

[in, optional] hMachine

Handle macchina fornito dal chiamante, ottenuto da una chiamata precedente a CM_Connect_Machine.

Nota L'uso di questa funzione per accedere ai computer remoti non è supportato a partire da Windows 8 e Windows Server 2012, perché questa funzionalità è stata rimossa.

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_Ex 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_Ex libera il descrittore di risorse, ma non l'handle del descrittore. Per liberare l'handle, chiamare CM_Free_Res_Des_Handle_Ex.

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

Le funzionalità per accedere ai computer remoti sono state rimosse in Windows 8 e Windows Server 2012 e sistemi operativi successivi, pertanto non è possibile accedere ai computer remoti durante l'esecuzione in queste versioni di Windows.

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

Condividi tramite