struttura HW_PROFILE_INFOA (winbase.h)

Articolo
08/27/2023

Contiene informazioni su un profilo hardware. La funzione GetCurrentHwProfile usa questa struttura per recuperare il profilo hardware corrente per il computer locale.

Sintassi

typedef struct tagHW_PROFILE_INFOA {
  DWORD dwDockInfo;
  CHAR  szHwProfileGuid[HW_PROFILE_GUIDLEN];
  CHAR  szHwProfileName[MAX_PROFILE_LEN];
} HW_PROFILE_INFOA, *LPHW_PROFILE_INFOA;

Members

dwDockInfo

Stato di ancoraggio segnalato del computer. Questo membro può essere una combinazione dei valori di bit seguenti.

Valore	Significato
DOCKINFO_DOCKED 0x2	Il computer è ancorato.
DOCKINFO_UNDOCKED 0x1	Il computer viene scollegato. Questo flag è sempre impostato per i sistemi desktop che non possono essere scollegati.
DOCKINFO_USER_SUPPLIED 0x4	Se questo flag è impostato, GetCurrentHwProfile ha recuperato lo stato di ancoraggio corrente dalle informazioni fornite dall'utente nella pagina Profili hardware dell'applicazione Pannello di controllo sistema . Se non è presente alcun valore o il valore è impostato su 0, questo flag viene impostato.
DOCKINFO_USER_DOCKED 0x5	Il computer è ancorato, in base alle informazioni fornite dall'utente. Questo valore è una combinazione dei flag di DOCKINFO_USER_SUPPLIED e di DOCKINFO_DOCKED.
DOCKINFO_USER_UNDOCKED 0x6	Il computer viene scollegato, in base alle informazioni fornite dall'utente. Questo valore è una combinazione dei flag di DOCKINFO_USER_SUPPLIED e di DOCKINFO_UNDOCKED.

szHwProfileGuid[HW_PROFILE_GUIDLEN]

Stringa GUID (Global Unique Identifier) per il profilo hardware corrente. La stringa restituita da GetCurrentHwProfile racchiude il GUID in parentesi graffe, {}ad esempio:

{12340001-4980-1920-6788-123456789012}

È possibile usare questa stringa come sottochiave del Registro di sistema nella chiave delle impostazioni di configurazione dell'applicazione in HKEY_CURRENT_USER. Ciò consente di archiviare le impostazioni per ogni profilo hardware.

szHwProfileName[MAX_PROFILE_LEN]

Nome visualizzato per il profilo hardware corrente.

Commenti

Nota

L'intestazione winbase.h definisce HW_PROFILE_INFO come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	winbase.h (include Windows.h)

Vedi anche

GetCurrentHwProfile

Condividi tramite