waveInGetErrorText 関数 (mmeapi.h)
waveInGetErrorText 関数は、指定されたエラー番号によって識別されたエラーのテキスト記述を取得します。
構文
MMRESULT waveInGetErrorText(
MMRESULT mmrError,
LPSTR pszText,
UINT cchText
);
パラメーター
mmrError
エラー番号。
pszText
テキスト エラーの説明を入力するバッファーへのポインター。
cchText
pszText が指すバッファーのサイズ (文字数)。
戻り値
成功した場合はMMSYSERR_NOERRORを返し、それ以外の場合はエラーを返します。 考えられるエラー値は次のとおりです。
リターン コード | 説明 |
---|---|
|
指定されたエラー番号が範囲外です。 |
|
デバイス ドライバーが存在しません。 |
|
メモリを割り当てまたはロックできません。 |
解説
テキスト・エラー記述が指定されたバッファーより長い場合、説明は切り捨てられます。 返されるエラー文字列は常に null で終わります。 cchText が 0 の場合、何もコピーされません。関数は 0 を返します。 すべてのエラー記述が MAXERRORLENGTH 文字未満です。
要件
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | mmeapi.h (Windows.h を含む) |
Library | Winmm.lib |
[DLL] | Winmm.dll |