Fungsi GetCurrentHwProfileA (winbase.h)

Mengambil informasi tentang profil perangkat keras saat ini untuk komputer lokal.

Sintaksis

BOOL GetCurrentHwProfileA(
  [out] LPHW_PROFILE_INFOA lpHwProfileInfo
);

Parameter

[out] lpHwProfileInfo

Penunjuk ke struktur HW_PROFILE_INFO yang menerima informasi tentang profil perangkat keras saat ini.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah nilai bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.

Komentar

Fungsi GetCurrentHwProfile mengambil nama tampilan dan string pengidentifikasi unik global (GUID) untuk profil perangkat keras. Fungsi ini juga mengambil status docking yang dilaporkan untuk komputer portabel dengan stasiun docking.

Sistem menghasilkan GUID untuk setiap profil perangkat keras dan menyimpannya sebagai string dalam registri. Anda dapat menggunakan GetCurrentHwProfile untuk mengambil string GUID untuk digunakan sebagai subkunci registri di bawah kunci pengaturan konfigurasi aplikasi Anda di HKEY_CURRENT_USER. Ini memungkinkan Anda menyimpan pengaturan setiap pengguna untuk setiap profil perangkat keras. Misalnya, aplikasi panel kontrol Colors dapat menggunakan subkunci untuk menyimpan preferensi warna setiap pengguna untuk profil perangkat keras yang berbeda, seperti profil untuk status yang ditampar dan dilepas. Aplikasi yang menggunakan fungsionalitas ini dapat memeriksa profil perangkat keras saat ini saat memulai, dan memperbarui pengaturannya.

Aplikasi juga dapat memperbarui pengaturan mereka ketika pesan perangkat sistem, seperti DBT_CONFIGCHANGED, menunjukkan bahwa profil perangkat keras telah berubah.

Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, tentukan makro _WIN32_WINNT sebagai 0x0400 atau yang lebih baru. Untuk informasi selengkapnya, lihat Menggunakan Header Windows.

Contoh

#include <windows.h>
#include <stdio.h>
#include <tchar.h>

void main(void) 
{
   HW_PROFILE_INFO   HwProfInfo;
   if (!GetCurrentHwProfile(&HwProfInfo)) 
   {
      _tprintf(TEXT("GetCurrentHwProfile failed with error %lx\n"), 
                 GetLastError());
      return;
   }
   _tprintf(TEXT("DockInfo = %d\n"), HwProfInfo.dwDockInfo);
   _tprintf(TEXT("Profile Guid = %s\n"), HwProfInfo.szHwProfileGuid);
   _tprintf(TEXT("Friendly Name = %s\n"), HwProfInfo.szHwProfileName);
}

Nota

Header winbase.h mendefinisikan GetCurrentHwProfile sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Advapi32.lib
DLL	Advapi32.dll
set API	ext-ms-win-advapi32-hwprof-l1-1-0 (diperkenalkan di Windows 10, versi 10.0.10240)

Lihat juga

DBT_CONFIGCHANGED

HW_PROFILE_INFO

Fungsi Informasi Sistem