MCIWndReturnString

  • Article

The MCIWndReturnString macro retrieves the reply to the most recent MCI string command sent to an MCI device. Information in the reply is supplied as a null-terminated string. You can use this macro or explicitly send the MCIWNDM_RETURNSTRING message.

LONG MCIWndReturnString(
  hwnd,  
  lp,    
  len    
);

Parameters

hwnd

Handle of the MCIWnd window.

lp

Pointer to an application-defined buffer to contain the null-terminated string.

len

Size, in bytes, of the buffer.

Return Values

Returns an integer corresponding to the MCI string.

Remarks

If the null-terminated string is longer than the buffer, the string is truncated.

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 Vfw.h.

See Also

MCIWNDM_RETURNSTRING