HW_PROFILE_INFOW struttura (winbase.h)

  • Articolo

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_INFOW {
  DWORD dwDockInfo;
  WCHAR szHwProfileGuid[HW_PROFILE_GUIDLEN];
  WCHAR szHwProfileName[MAX_PROFILE_LEN];
} HW_PROFILE_INFOW, *LPHW_PROFILE_INFOW;

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