funzione CM_Free_Res_Des_Handle (cfgmgr32.h)

La funzione CM_Free_Res_Des_Handle invalida un handle di descrizione della risorsa e libera l'allocazione di memoria associata.

Sintassi

CMAPI CONFIGRET CM_Free_Res_Des_Handle(
  [in] RES_DES rdResDes
);

Parametri

[in] rdResDes

Handle del descrittore di risorse fornito dal chiamante da liberare. 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

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.

Commenti

Ogni volta che il codice chiama una delle funzioni elencate sotto la descrizione di rdResDes, deve successivamente chiamare CM_Free_Res_Des_Handle.

Requisiti