struktur HW_PROFILE_INFOW (winbase.h)

Berisi informasi tentang profil perangkat keras. Fungsi GetCurrentHwProfile menggunakan struktur ini untuk mengambil profil perangkat keras saat ini untuk komputer lokal.

Sintaksis

typedef struct tagHW_PROFILE_INFOW {
  DWORD dwDockInfo;
  WCHAR szHwProfileGuid[HW_PROFILE_GUIDLEN];
  WCHAR szHwProfileName[MAX_PROFILE_LEN];
} HW_PROFILE_INFOW, *LPHW_PROFILE_INFOW;

Anggota

dwDockInfo

Status docking komputer yang dilaporkan. Anggota ini bisa menjadi kombinasi dari nilai bit berikut.

Nilai	Arti
DOCKINFO_DOCKED 0x2	Komputer ditampung.
DOCKINFO_UNDOCKED 0x1	Komputer dilepas. Bendera ini selalu diatur untuk sistem desktop yang tidak dapat dilepas.
DOCKINFO_USER_SUPPLIED 0x4	Jika bendera ini diatur, GetCurrentHwProfile mengambil status docking saat ini dari informasi yang disediakan oleh pengguna di halaman Profil Perangkat Keras aplikasi panel kontrol Sistem . Jika tidak ada nilai seperti itu atau nilai diatur ke 0, bendera ini diatur.
DOCKINFO_USER_DOCKED 0x5	Komputer ditampung, sesuai dengan informasi yang diberikan oleh pengguna. Nilai ini adalah kombinasi dari bendera DOCKINFO_USER_SUPPLIED dan DOCKINFO_DOCKED.
DOCKINFO_USER_UNDOCKED 0x6	Komputer dilepas, sesuai dengan informasi yang diberikan oleh pengguna. Nilai ini adalah kombinasi dari bendera DOCKINFO_USER_SUPPLIED dan DOCKINFO_UNDOCKED.

szHwProfileGuid[HW_PROFILE_GUIDLEN]

String pengidentifikasi unik global (GUID) untuk profil perangkat keras saat ini. String yang dikembalikan oleh GetCurrentHwProfile mengapit GUID dalam kurung kurawal, ; misalnya:

{12340001-4980-1920-6788-123456789012}

Anda dapat menggunakan string ini sebagai subkuncu registri di bawah kunci pengaturan konfigurasi aplikasi Anda di HKEY_CURRENT_USER. Ini memungkinkan Anda menyimpan pengaturan untuk setiap profil perangkat keras.

szHwProfileName[MAX_PROFILE_LEN]

Nama tampilan untuk profil perangkat keras saat ini.

Komentar

Nota

Header winbase.h mendefinisikan HW_PROFILE_INFO sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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]
Header	winbase.h (termasuk Windows.h)

Lihat juga

GetCurrentHwProfile