<Return[UV]><Top>

VerLanguageName

Declare Function Api_VerLanguageName& Lib "kernel32" Alias "VerLanguageNameA" (ByVal wLang&, ByVal szLang$, ByVal nSize&)

Declare Function VerLanguageName Lib "kernel32" Alias "VerLanguageNameA" (ByVal wLang As Long, ByVal szLang As String, ByVal nSize As Long) As Long

指定されたバイナリの Microsoft 言語識別子と関連付けられた、言語の記述文字列を検索する。

パラメータ
wLang
    バイナリの Microsoft 言語識別子を指定する。
    たとえば、言語識別子 0x040A に関連付けられた記述文字列は "Spanish (Traditional Sort)" である。言語識別子が不明な場合は、

    szLang パラメータは既定の文字列("Language Neutral")を指す。
szLang
    wLang パラメータで指定した言語を表す、NULL で終わる文字列を受け取るバッファへのポインタを指定する。
nSize
    szLang パラメータで指定されたバッファのサイズを文字数で表す。

戻り値
    戻り値がバッファサイズ以下の場合、この値はバッファに返された文字列の文字数を表す。

    この値には、終端の NULL 文字は含まれない。
    戻り値がバッファサイズより大きい場合、この値は文字列全体を保持するのに必要なバッファのサイズを表す。

    実際の文字列は、既存のバッファサイズに合わせて切り捨てられる。
    エラーが発生すると、0 が返る。言語識別子が不明な場合は、エラーにはならない。

解説
    通常、インストールプログラムでこの関数を使って、VerQueryValue 関数から返される言語識別子を変換する。

    テキスト文字列は、言語が競合した場合にインストールの進め方をユーザーに確認するためのダイアログボックスで使われる。