CM_Free_Res_Des_Handle-Funktion (cfgmgr32.h)

  • Artikel

Die funktion CM_Free_Res_Des_Handle ungültig ein Ressourcenbeschreibungshandle und gibt die zugeordnete Speicherbelegung frei.

Syntax

CMAPI CONFIGRET CM_Free_Res_Des_Handle(
  [in] RES_DES rdResDes
);

Parameter

[in] rdResDes

Vom Aufrufer bereitgestelltes Ressourcendeskriptorhandle, das freigegeben werden soll. Dieses Handle muss zuvor durch Aufrufen einer der folgenden Funktionen abgerufen worden sein:

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

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion CR_SUCCESS zurück. Andernfalls wird einer der in Cfgmgr32.h definierten Fehlercodes mit CR_ Präfix zurückgegeben.

Hinweise

Jedes Mal, wenn Ihr Code eine der funktionen aufruft, die unter der Beschreibung von rdResDes aufgeführt sind, muss er anschließend CM_Free_Res_Des_Handle aufrufen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows.
Zielplattform Desktop
Kopfzeile cfgmgr32.h (include Cfgmgr32.h)
Bibliothek Cfgmgr32.lib
DLL Cfgmgr32.dll