MimeGetAttachedFileName Function  
 
BOOL WINAPI MimeGetAttachedFileName(
  HMESSAGE hMessage,  
  LPTSTR lpszFileName,  
  INT cchFileName  
);

The MimeGetAttachedFileName function returns the file name for the attachment to the current message part.

Parameters

hMessage
Handle to the message.
lpszFileName
Pointer to a buffer that will contain the current attachment file name as a null-terminated string.
cchFileName
The maximum number of characters that may be copied into the buffer, including the terminating null-byte.

Return Value

If the function succeeds, the return value is non-zero. If the function fails, the return value is zero. To get extended error information, call MimeGetLastError.

Remarks

The function will first try to get the filename from the Content-Disposition header field. If this field does not exist, it then attempts to get the name from the Content-Type header field. If neither field exists, the function will fail.

Requirements

Client: Requires Windows 7, Windows Vista or Windows XP.
Server: Requires Windows Server 2008 or Windows Server 2003.
Header: Include cstools7.h.
Library: Use csmsgav7.lib.
Unicode: Implemented as Unicode and ANSI versions.

See Also

MimeAttachFile, MimeEnumAttachments, MimeExtractFile, MimeFindAttachment