<Return[MN]><Top>

midiOutGetErrorText

Declare Function Api_midiOutGetErrorText& Lib "winmm" Alias "midiOutGetErrorTextA" (ByVal mmrError&, ByVal lpText$, ByVal cchText&)

Declare Function midiOutGetErrorText Lib "winmm" Alias "midiOutGetErrorTextA" (ByVal mmrError As Long, ByVal lpText As String, ByVal cchText As Long) As Long

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

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

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

    値                                             

説明                                                               

    MMSYSERR_BADERRNUM

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

    MMSYSERR_INVALPARAM

指定されたデバイスハンドルは無効である。

    MMSYSERR_NOMEM

システムはマッパー文字列記述をロードできない。


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

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

    MAXERRORLENGTH 未満である。