| |
| INT CreatePart( |
| |
LPCTSTR lpszText, |
|
| |
UINT nCharacterSet, |
|
| |
UINT nEncodingType |
|
| ); |
The CreatePart method creates a new part for the specified
message. If this the first part created for a message that does not
have the multipart content type specified, the message is marked as
multipart and the header fields are updated.
Parameters
- lpszText
- A pointer to a string which specifies the text
to be included in the body of the new message part. If this
parameter is NULL or points to an empty string, no text is added to
the message part.
-
- nCharacterSet
- A numeric identifier which specifies the
character set to use when composing the message. A value of zero
specifies the character set should be the same character set used to
initially compose the message. It is recommended that you always use
UTF-8 when composing a new message or creating a new message part.
- nEncodingType
- A numeric identifier which specifies the encoding type to use
when composing the message. A value of zero specifies that default
7bit encoding should be used. The following values may also be
used:
| Value |
Description |
| MIME_ENCODING_7BIT |
Each character is encoded in one or more bytes, with each
byte being 8 bits long, with the most significant bit cleared. This
encoding is most commonly used with plain text using the US-ASCII
character set, where each character is represented by a single byte
in the range of 20h to 7Eh. |
| MIME_ENCODING_8BIT |
Each character is encoded in one or more bytes, with each
byte being 8 bits long and all bits are used. 8-bit encoding
is typically used with multibyte character sets and is the default
encoding used with Unicode text. |
| MIME_ENCODING_QUOTED |
Quoted-printable encoding is designed for textual messages
where most of the characters are represented by the ASCII
character set and is generally human-readable. Non-printable
characters or 8-bit characters with the high bit set are
encoded as hexadecimal values and represented as 7-bit text.
Quoted-printable encoding is typically used for messages which
use character sets such as ISO-8859-1, as well as those which
use HTML. |
| MIME_ENCODING_BASE64 |
Base64 encoding converts binary or text data to ASCII by
translating it so each base64 digit represents 6 bits of data.
This encoding method is commonly used with messages that contain
binary data (such as binary file attachments), or when text uses
extended characters that cannot be represented by 7-bit ASCII.
It is recommended that you use base64 encoding with Unicode
text. |
Return Value
If the method succeeds, the return value is the new message part
number. If the method fails, the return value is MIME_ERROR. To get
extended error information, call GetLastError.
Requirements
Minimum Desktop Platform: Windows 7 Service Pack 1
Minimum Server Platform: Windows Server 2008 R2 Service Pack 1
Header File: cstools11.h
Import Library: csmsgv11.lib
Unicode: Implemented as Unicode and ANSI versions
See Also
AttachFile,
ComposeMessage,
CreatePart,
DeletePart, GetPart,
GetPartCount,
SetPart
|
|