Funzione InstallLayoutOrTip

  • Articolo

Abilita i layout di tastiera o i servizi di testo specificati.

Sintassi

BOOL CALLBACK InstallLayoutOrTip(
  _In_ LPCWSTR psz,
  _In_ DWORD   dwFlags
);

Parametri

psz [in]

Stringa che rappresenta l'elenco di layout della tastiera o l'elenco di profili dei servizi di testo.

dwFlags [in]

Campo di bit che specifica i flag seguenti:

Nota

Gli identificatori seguenti non sono definiti in un file di intestazione pubblica. È necessario usare il valore esadecimale o #define gli identificatori. Ad esempio, per usare ILOT_UNINSTALL è necessario includere #define ILOT_UNINSTALL 0x00000001 nel codice.

Valore Significato
ILOT_UNINSTALL
0x00000001
 Uguale a ILOT_DISABLED.
ILOT_DEFPROFILE
0x00000002
 Imposta il layout o il suggerimento specificati come elemento predefinito.
ILOT_DEFUSER4
0x00000004
 Modifica l'impostazione di . Predefinito.
ILOT_SYSLOCALE
0x00000008
 Non utilizzato.
ILOT_NOLOCALETOENUMERATE
0x00000010
 Non utilizzato.
ILOT_NOAPPLYTOCURRENTSESSION
0x00000020
 L'impostazione viene salvata ma non viene applicata alla sessione corrente.
ILOT_CLEANINSTALL
0x00000040
 Disabilita tutti i layout e i servizi di testo correnti della tastiera.
ILOT_DISABLED
0x00000080
 Disabilita il layout della tastiera e il servizio di testo specificati.

Valore restituito

Codice restituito Descrizione
TRUE
 La funzione ha avuto esito positivo.
FALSE
 Si è verificato un errore non specificato.

Commenti

Il formato stringa dell'elenco di layout è:

<LangID 1>:<KLID 1>;[ ...< LangID N>:<KLID N>

Il formato stringa dell'elenco di profili del servizio di testo è:

<LangID 1>:{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx};

Di seguito è riportato un esempio di valore per il parametro psz :

"0x0407:0x00000407"
"0x0407:0x00000407;0x040C:0x0000040C"
"0x0407:0x00000407;0x0412:{A028AE76-01B1-46C2-99C4-ACD9858AE02F}{B5FE1F02-D5F2-4445-9C03-C568F23C99A1};0x040C:0x0000040C"

Esempio

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

Nota

L'uso di LoadLibrary in modo non corretto 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 a collegamento dinamico .

typedef HRESULT (WINAPI *PTF_ INSTALLLAYOUTORTIP)(LPCWSTR psz, DWORD dwFlasg);

HMODULE hInputDLL = LoadLibrary(TEXT("input.dll"));
BOOL bRet = FALSE;

if(hInputDLL == NULL)
{
    // Error loading module; fail as securely as possible. 
}
else
{
    PTF_ INSTALLLAYOUTORTIP pfnInstallLayoutOrTip;
    
    pfnInstallLayoutOrTip = (PTF_ INSTALLLAYOUTORTIP)GetProcAddress(hInputDLL, "InstallLayoutOrTip");

    if(pfnInstallLayoutOrTip)
    {
        bRet = (*pfnInstallLayoutOrTip)(psz, dwFlags);
    }

    FreeLibrary(hInputDLL);
}

Requisiti

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