Funzione EnumEnabledLayoutOrTip

Articolo
06/13/2023

Enumera tutti i layout di tastiera abilitati o i servizi di testo dell'impostazione utente specificata.

Sintassi

UINT EnumEnabledLayoutOrTip(
  _In_opt_ LPCWSTR            pszUserReg,
  _In_opt_ LPCWSTR            pszSystemReg,
  _In_opt_ LPCWSTR            pszSoftwareReg,
  _Out_    LAYOUTORTIPPROFILE *pLayoutOrTipProfile,
  _In_     UINT               uBufLength
);

Parametri

pszUserReg [in, facoltativo]: Percorso del Registro di sistema dell'utente. Se questo parametro è NULL, viene usato HKEY_CURRENT_USER.
pszSystemReg [in, facoltativo]: Percorso del Registro di sistema. Se questo parametro è NULL, viene usato HKEY_LOCAL_MACHINE\System.
pszSoftwareReg [in, facoltativo]: Percorso del Registro di sistema del software. Se questo parametro è NULL, viene usato HKEY_LOCAL_MACHINE\Software.
pLayoutOrTipProfile [out]: Puntatore al buffer che riceve la matrice LAYOUTORTIPPROFILE.
uBufLength [in]: Lunghezza del buffer a cui punta pLayoutOrTipProfile.

Valore restituito

Se pLayoutOrTipProfile è NULL, il numero di elementi della tastiera abilitati nell'impostazione utente; in caso contrario, il numero di elementi della tastiera copiati in pLayoutOrTipProfile.

Per le lingue IME (Input Method Editor) vengono restituite tutte le ENTITÀ, anche quando è abilitato un solo IME. Ad esempio, se un utente ha abilitato CHT New Quick IME, la funzione EnumEnabledLayoutOrTip restituisce tutti i 5 CHT IMEs.

Commenti

Non è disponibile alcuna libreria di importazione che definisce questa funzione, pertanto è necessario ottenere un puntatore a questa funzione usando LoadLibrary e GetProcAddress.

Nota

L'uso di LoadLibrary in modo errato può compromettere la sicurezza dell'applicazione caricando la DLL errata. Per informazioni su come caricare correttamente le DLL con versioni diverse di Microsoft Windows, vedere Ordine di ricerca libreria di collegamento dinamico .

La definizione di LAYOUTORTIPPROFILE è:

typedef struct tagLAYOUTORTIPPROFILE {
    DWORD  dwProfileType;       // InputProcessor or HKL 
#define LOTP_INPUTPROCESSOR 1
#define LOTP_KEYBOARDLAYOUT 2
    LANGID langid;              // language id 
    CLSID  clsid;               // CLSID of tip 
    GUID   guidProfile;         // profile description 
    GUID   catid;               // category of tip 
    DWORD  dwSubstituteLayout;  // substitute hkl 
    DWORD  dwFlags;             // Flags 
    WCHAR  szId[MAX_PATH];      // KLID or TIP profile for string 
} LAYOUTORTIPPROFILE;

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
DLL	Input.dll

Condividi tramite