Fungsi SHRunControlPanel (shlobj.h)

Artikel
08/26/2023

Membuka item Panel Kontrol.

Catatan Fungsi ini tidak didukung pada Windows Vista

Sintaks

BOOL SHRunControlPanel(
  [in]           PCWSTR lpcszCmdLine,
  [in, optional] HWND   hwndMsgParent
);

Parameter

[in] lpcszCmdLine

Jenis: PCWSTR

Penunjuk ke string yang berisi baris perintah yang membuka item Panel Kontrol. Baris perintah ini mencakup setidaknya nama file .cpl. Ini juga dapat berisi informasi lain yang diperlukan seperti halaman lembar properti dalam item (baik berdasarkan ordinal atau berdasarkan nama). Untuk informasi selengkapnya, lihat Mengeksekusi Item Panel Kontrol.

[in, optional] hwndMsgParent

Jenis: HWND

Handel jendela induk, digunakan untuk menampilkan pesan kesalahan tentang pembukaan item. Nilai ini bisa NULL.

Menampilkan nilai

Jenis: BOOL

TRUE jika item Panel Kontrol berhasil dibuka; jika tidak, FALSE.

Pada Windows Vista, fungsi ini selalu mengembalikan FALSE.

Keterangan

Jika item Panel Kontrol yang ditentukan sudah berjalan, SHRunControlPanel mencoba beralih ke instans tersebut daripada membuka instans baru.

Contoh

Contoh panggilan ke SHRunControlPanel ditampilkan di sini.

SHRunControlPanel(TEXT("timedate.cpl"), hwnd);
SHRunControlPanel(L"appwiz.cpl", NULL);
SHRunControlPanel(L"appwiz.cpl,2", NULL);
SHRunControlPanel("desk.cpl,Settings", hwnd

Persyaratan


Klien minimum yang didukung	Windows XP dengan SP1 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	shlobj.h
DLL	Shell32.dll

Bagikan melalui