MimeSetMessageHeaderEx Function  
 
BOOL WINAPI MimeSetMessageHeaderEx(
  HMESSAGE hMessage,  
  INT nMessagePart,  
  LPCTSTR lpszHeader,  
  LPCTSTR lpszValue,  
  DWORD dwReserved  
);

The MimeSetMessageHeaderEx function adds or updates a header field in the specified message.

Parameters

hMessage
Handle to the message.
nMessagePart
An integer value which specifies which part of the message the header should be set or modified in. A value of zero sets a header value in the main message header block, while a value greater than zero sets the header value in that specific part of a multipart message. A value of -1 specifies that the header value should be set in the current message part.
lpszHeader
Pointer to a null-terminated string which specifies the header field that will be added or updated.
lpszValue
Pointer to a null-terminated string which specifies the value for the header field. This pointer may be NULL, which causes the header field to be removed from the message.
dwReserved
A reserved parameter. This value should always be zero.

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.

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

MimeEnumMessageHeaders, MimeGetFirstMessageHeader, MimeGetMessageHeader, MimeGetMessagePart, MimeGetNextMessageHeader, MimeSetMessagePart, MimeSetMessageText