CM_Free_Log_Conf (cfgmgr32.h)

Fungsi CM_Free_Log_Conf menghapus konfigurasi logis dan semua deskriptor sumber daya terkait dari komputer lokal.

Sintaks

CMAPI CONFIGRET CM_Free_Log_Conf(
  [in] LOG_CONF lcLogConfToBeFreed,
  [in] ULONG    ulFlags
);

Parameter

[in] lcLogConfToBeFreed

Handel yang disediakan penelepon ke konfigurasi logis. Handel ini harus telah diperoleh sebelumnya dengan memanggil salah satu fungsi berikut:

CM_Add_Empty_Log_Conf

CM_Add_Empty_Log_Conf_Ex

CM_Get_First_Log_Conf

CM_Get_First_Log_Conf_Ex

CM_Get_Next_Log_Conf

CM_Get_Next_Log_Conf_Ex

[in] ulFlags

Tidak digunakan, harus nol.

Menampilkan nilai

Jika operasi berhasil, fungsi akan mengembalikan CR_SUCCESS. Jika tidak, ia mengembalikan salah satu kode kesalahan awalan CR_ yang ditentukan dalam Cfgmgr32.h.

Catatan Dimulai dengan Windows 8, CM_Free_Log_Conf mengembalikan CR_CALL_NOT_IMPLEMENTED saat digunakan dalam skenario Wow64. Untuk meminta informasi tentang sumber daya perangkat keras pada komputer lokal, perlu menerapkan versi arsitektur-asli aplikasi menggunakan API sumber daya perangkat keras. Misalnya: Aplikasi AMD64 untuk sistem AMD64.

 

Keterangan

Memanggil CM_Free_Log_Conf dapat menyebabkan handel yang dikembalikan oleh CM_Get_First_Log_Conf dan CM_Get_Next_Log_Conf menjadi tidak valid. Jadi, jika Anda ingin mendapatkan konfigurasi logis setelah memanggil CM_Free_Log_Conf, kode Anda harus memanggil CM_Get_First_Log_Conf lagi dan memulai pada konfigurasi pertama.

Perhatikan bahwa memanggil CM_Free_Log_Conf membebaskan konfigurasi, tetapi bukan pegangan konfigurasi. Untuk membebaskan handel, panggil CM_Free_Log_Conf_Handle.

Pemanggil fungsi ini harus memiliki SeLoadDriverPrivilege. (Hak istimewa dijelaskan dalam dokumentasi Microsoft Windows SDK.)

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Microsoft Windows 2000 dan versi Windows yang lebih baru.
Target Platform	Desktop
Header	cfgmgr32.h (termasuk Cfgmgr32.h)
Pustaka	Cfgmgr32.lib
DLL	Cfgmgr32.dll

Lihat juga

CM_Free_Log_Conf_Ex