|
|
| BOOL
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 is to 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 Vista, Windows XP or Windows
2000 Professional.
Server: Requires Windows Server 2008, Windows Server 2003 or
Windows 2000 Server.
Header: Include cstools6.h.
Library: Use csmsgav6.lib.
Unicode: Implemented as Unicode and ANSI versions.
See Also
MimeEnumMessageHeaders, MimeGetFirstMessageHeader,
MimeGetMessageHeader,
MimeGetMessagePart, MimeGetNextMessageHeader,
MimeSetMessagePart, MimeSetMessageText
|
|