mciGetErrorString

The mciGetErrorString function retrieves a string that describes the specified MCI error code.

BOOL mciGetErrorString(
  DWORD fdwError,        
  LPTSTR lpszErrorText,  
  UINT cchErrorText      
);

Parameters

fdwError

Error code returned by the mciSendCommand or mciSendString function.

lpszErrorText

Pointer to a buffer that receives a null-terminated string describing the specified error.

cchErrorText

Length of the buffer, in characters, pointed to by the lpszErrorText parameter.

Return Values

Returns TRUE if successful or FALSE if the error code is not known.

Remarks

Each string that MCI returns, whether data or an error description, can be a maximum of 128 characters.

Requirements

**  Windows NT/2000/XP:** Included in Windows NT 3.1 and later.
**  Windows 95/98/Me:** Included in Windows 95 and later.
**  Header:** Declared in Mmsystem.h; include Windows.h.
**  Library:** Use Winmm.lib.
**  Unicode:** Implemented as Unicode and ANSI versions on Windows NT/2000/XP.

See Also

MCI, MCI Functions, mciSendCommand, mciSendString