struttura HW_PROFILE_INFOA (winbase.h)

Articolo
11/20/2024

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;

Membri

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 è scollegato. Questo flag è sempre impostato per i sistemi desktop che non possono essere scollegati.
DOCKINFO_USER_SUPPLIED 0x4	Se questo flag è impostato, GetCurrentHwProfile recuperato lo stato di ancoraggio corrente dalle informazioni fornite dall'utente nella pagina Profili hardware dell'applicazione del pannello di controllo di sistema . Se non esiste un valore di questo tipo 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 di flag DOCKINFO_USER_SUPPLIED e DOCKINFO_DOCKED.
DOCKINFO_USER_UNDOCKED 0x6	Il computer viene scollegato, in base alle informazioni fornite dall'utente. Questo valore è una combinazione dei flag DOCKINFO_USER_SUPPLIED e DOCKINFO_UNDOCKED.

szHwProfileGuid[HW_PROFILE_GUIDLEN]

Stringa dell'identificatore univoco globale (GUID) per il profilo hardware corrente. La stringa restituita da GetCurrentHwProfile racchiude il GUID tra parentesi graffe {}; Per 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. In questo modo è possibile archiviare le impostazioni per ogni profilo hardware.

szHwProfileName[MAX_PROFILE_LEN]

Nome visualizzato per il profilo hardware corrente.

Osservazioni

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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

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)

Vedere anche

GetCurrentHwProfile

Condividi tramite