Compartilhar via


Função EnumEnabledLayoutOrTip

Enumera todos os layouts de teclado ou serviços de texto habilitados da configuração de usuário especificada.

Sintaxe

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

Parâmetros

pszUserReg [in, opcional]

O caminho do registro do usuário. Se esse parâmetro for NULL, HKEY_CURRENT_USER será usado.

pszSystemReg [in, opcional]

O caminho do registro do sistema. Se esse parâmetro for NULL, HKEY_LOCAL_MACHINE\System será usado.

pszSoftwareReg [in, opcional]

O caminho do registro do software. Se esse parâmetro for NULL, HKEY_LOCAL_MACHINE\Software será usado.

pLayoutOrTipProfile [out]

Ponteiro para o buffer que recebe a matriz LAYOUTORTIPPROFILE.

uBufLength [in]

O comprimento do buffer apontado por pLayoutOrTipProfile.

Valor retornado

Se pLayoutOrTipProfile for NULL, o número de itens de teclado habilitados na configuração do usuário; caso contrário, o número de itens de teclado copiados para pLayoutOrTipProfile.

Para linguagens IME (Editor de Método de Entrada), todos os IMEs são retornados, mesmo quando apenas um IME está habilitado. Por exemplo, se um usuário tiver o CHT Novo IME Rápido habilitado, a função EnumEnabledLayoutOrTip retornará todos os 5 IMEs de CHT.

Comentários

Não há nenhuma biblioteca de importação disponível que defina essa função, portanto, é necessário obter um ponteiro para essa função usando LoadLibrary e GetProcAddress.

Observação

Usar LoadLibrary incorretamente pode comprometer a segurança do aplicativo carregando a DLL errada. Consulte a Ordem de Pesquisa da Biblioteca de Link Dinâmico para obter informações sobre como carregar corretamente DLLs com diferentes versões do Microsoft Windows.

A definição de 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;

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2008 [somente aplicativos da área de trabalho]
DLL
Input.dll