MCIWndGetError

The MCIWndGetError macro retrieves the last MCI error encountered. You can use this macro or explicitly send the MCIWNDM_GETERROR message.

LONG MCIWndGetError(
  hwnd,  
  lp,    
  len    
);
 

Parameters

hwnd

Handle of the MCIWnd window.

lp

Address of an application-defined buffer used to return the error string.

len

Size, in bytes, of the error buffer.

Return Values

Returns the integer error value if successful.

Remarks

If lp is a valid pointer, a null-terminated string corresponding to the error is returned in its buffer. If the error string is longer than the buffer, MCIWnd truncates it.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in vfw.h.

See Also

MCIWnd Window Class Overview, MCIWnd Macros, MCIWNDM_GETERROR