<Return[MN]><Top>

midiInGetErrorText

Declare Function Api_midiInGetErrorText& Lib "winmm" Alias "midiInGetErrorTextA" (ByVal wError&, ByVal lpText$, ByVal cchText&)

Declare Function midiInGetErrorText Lib "winmm" Alias "midiInGetErrorTextA" (ByVal wError As Long, ByVal lpText As String, ByVal cchText As Long) As Long

指定されたエラーコードで識別される、エラーの原文記述を取得する。

パラメータ
wError
    エラーコードを指定する。
lpText
    エラーの原文記述が入るバッファのアドレスを指定する。
cchText
    lpText パラメータで指定したバッファの長さを文字数で指定する。

戻り値
    関数が成功すると、MMSYSERR_NOERROR が返る。関数が失敗すると、エラーが返る。返されるエラー値は次のとおりである。

    値                                             

説明                                                                                                 

    MMSYSERR_BADERRNUM

指定されたエラー番号は範囲外である。

    MMSYSERR_INVALPARAM

指定されたポインタまたは構造体は無効である。

    MMSYSERR_NOMEM

システムはメモリを割り当てられないか、またはロックできない。


解説
    エラーの原文記述が指定したバッファよりも長い場合、その記述は切り捨てられる。返されたエラー文字列は常に NULL で終わる。

    cchText パラメータが 0 の場合は何もコピーされず、関数は 0 を返す。すべてのエラー記述の長さは、MAXERRORLENGTH 文字数未

    満である。