MCIWndGetFileName macro (vfw.h)

The MCIWndGetFileName macro retrieves the filename used by an MCI device. You can use this macro or explicitly send the MCIWNDM_GETFILENAME message.

Syntax

LONG MCIWndGetFileName(
     hwnd,
     lp,
     len
);

Parameters

hwnd

Handle of the MCIWnd window.

lp

Pointer to an application-defined buffer to return the filename.

len

Size, in bytes, of the buffer.

Return value

Type: LONG

Returns zero if successful or 1 otherwise.

Remarks

If the null-terminated string containing the filename is longer than the buffer, MCIWnd truncates the filename.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	vfw.h

See also

MCIWNDM_GETFILENAME