SetDefaultLayoutOrTip 関数

指定したキーボード レイアウトまたはテキスト サービスを、現在のユーザーの既定の入力項目として設定します。

構文

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

パラメーター

psz [in]

キーボード レイアウト リストまたはテキスト サービスのプロファイル リストを表す文字列。

dwFlags [in]

以下のフラグを指定するビットフィールド。

Note

次の識別子は、public ヘッダー ファイルでは定義されていません。 16 進数の値を使用するか、識別子を #define する必要があります。 たとえば、SDLOT_NOAPPLYTOCURRENTSESSION を使用するには、コードに #define SDLOT_NOAPPLYTOCURRENTSESSION 0x00000001 を含める必要があります。

値	意味
SDLOT_NOAPPLYTOCURRENTSESSION 0x00000001	レジストリに設定を格納しますが、現在のセッションのランタイム キーボード設定は更新しません。 SetDefaultLayoutOrTipUserReg で代替レジストリ パスが設定されている場合は、このフラグを設定する必要があります。
SDLOT_APPLYTOCURRENTTHREAD 0x00000002	現在のスレッドに設定を直ちに適用します。

戻り値

解説

レイアウト リストの文字列形式は次のとおりです。

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

テキスト サービス プロファイル リストの文字列形式は次のとおりです。

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

psz パラメーターの値の例を次に示します。

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

例

この関数を定義するインポート ライブラリはないため、LoadLibrary と GetProcAddress を使用してこの関数へのポインターを取得する必要があります。 次の例では、この関数へのポインターを取得する方法を示します。

typedef HRESULT (WINAPI *PTF_ SETDEFAULTLAYOUTORTIP)(LPCWSTR psz);

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

if(hInputDLL == NULL)
{
    // Error loading module; fail as securely as possible. 
}
else
{
    PTF_ SETDEFAULTLAYOUTORTIP pfnSetDefaultLayoutOrTip;
    
    pfnSetDefaultLayoutOrTip = (PTF_ SETDEFAULTLAYOUTORTIP)GetProcAddress(hInputDLL, "SetDefaultLayoutOrTip");

    if(pfnSetDefaultLayoutOrTip)
    {
        bRet = (*pfnSetDefaultLayoutOrTip)(psz);
    }

    FreeLibrary(hInputDLL);
}

要件