Mime

Gets or sets the raw boundary token used by a multipart MIME entity. Do not include surrounding quotation marks.

Content-Type: multipart/mixed; boundary="example-boundary"

Gets or sets the charset parameter of the Content-Type header field.

Content-Type: text/plain; charset=utf-8

Gets or sets a JSON string containing advanced CMS/PKCS #7 signing and validation options. The empty string selects normal behavior. This property is intended for specialized interoperability requirements; applications should leave it empty unless a documented option is specifically needed.

Gets or sets the MIME media type of the current part, excluding all parameters. Supply a value such as text/plain, text/html, application/pdf, or multipart/mixed; do not include charset, boundary, or other parameters in this property.

Changing the media type preserves the existing charset and unrecognized parameters, but may remove parameters that are specific to the previous media type, such as format=flowed. Setting an empty string leaves an empty media type and can therefore produce an invalid-looking header if other parameters remain.

Returns the current local date and time formatted as an Internet message date, including the numeric UTC offset. For example:

Fri, 21 Nov 1997 09:55:06 -0600

If set to a file path, this property logs the LastErrorText of each Chilkat method or property call to the specified file. This logging helps identify the context and history of Chilkat calls leading up to any crash or hang, aiding in debugging.

Enabling the VerboseLogging property provides more detailed information. This property is mainly used for debugging rare instances where a Chilkat method call causes a hang or crash, which should generally not happen.

Possible causes of hangs include:

• A timeout property set to 0, indicating an infinite timeout.
• A hang occurring within an event callback in the application code.
• An internal bug in the Chilkat code causing the hang.

Gets or sets the disposition value from the Content-Disposition header field, excluding parameters such as filename.

Content-Disposition: attachment; filename="report.pdf"

Gets or sets the value of the Content-Transfer-Encoding header field for the current part. Common values include base64, quoted-printable, 7bit, 8bit, and binary.

Gets or sets the filename parameter of the Content-Disposition header field. The value is a receiver-facing filename, not a local filesystem path.

Changing this property preserves the disposition value but removes other Content-Disposition parameters such as size. Setting an empty string removes the filename parameter.

Provides HTML-formatted information about the last called method or property. If a method call fails or behaves unexpectedly, check this property for details. Note that information is available regardless of the method call's success.

Provides plain text information about the last called method or property. If a method call fails or behaves unexpectedly, check this property for details. Note that information is available regardless of the method call's success.

Provides XML-formatted information about the last called method or property. If a method call fails or behaves unexpectedly, check this property for details. Note that information is available regardless of the method call's success.

Indicates the success or failure of the most recent method call: TRUE means success, FALSE means failure. This property remains unchanged by property setters or getters. This method is present to address challenges in checking for null or Nothing returns in certain programming languages. Note: This property does not apply to methods that return integer values or to boolean-returning methods where the boolean does not indicate success or failure.

Gets or sets the micalg parameter of a multipart/signed Content-Type header field.

Content-Type: multipart/signed;
  protocol="application/pkcs7-signature";
  micalg=sha-256;
  boundary="example-boundary"

Gets or sets the name parameter of the Content-Type header field. For attachments, Filename is generally the primary receiver-facing name.

Setting a non-ASCII value causes Chilkat to emit an RFC 2047 encoded-word in the name= parameter. Setting this property when no media type exists creates a Content-Type field with an empty media type.

Returns the number of decryption certificates recorded by the most recent call to UnwrapSecurity. Use LastDecryptCert with a zero-based index to retrieve each certificate.

Returns the number of header-field occurrences in the current part. Duplicate names count separately and retain their order. Valid indexes range from 0 through NumHeaderFields - 1 for use with GetHeaderFieldName and GetHeaderFieldValue.

During MIME parsing, duplicate ordinary fields are retained. Duplicate Content-Type fields are collapsed, with the last value taking effect.

Returns the number of direct child parts. It does not include deeper descendants. Iterate from 0 through NumParts - 1 and call PartAt to traverse the tree.

The object returned by PartAt provides live access to the stored child. Modifying that returned object modifies the parent MIME tree.

Returns the number of signer certificates recorded by the most recent signature-verification or security-unwrapping operation. The property is populated by UnwrapSecurity. Use LastSignerCert to retrieve a certificate by zero-based index.

Gets or sets the hash algorithm used by RSAES-OAEP when encrypting the CMS content-encryption key. Supported values are sha1, sha256, sha384, and sha512. This property is used only when OaepPadding is TRUE.

Gets or sets the hash algorithm used by the mask generation function (MGF1) within RSAES-OAEP. Supported values are sha1, sha256, sha384, and sha512. The default is sha1. This property is used only when OaepPadding is TRUE.

Selects the RSA key-transport padding used when creating encrypted MIME. The default is FALSE, which uses RSAES-PKCS1-v1_5. Set to TRUE to use RSAES-OAEP.

Gets or sets the symmetric content-encryption algorithm used when creating CMS/PKCS #7 encrypted MIME. Supported values are aes, aes-gcm, des, 3des, and rc2. The default is aes. The aes-gcm option was added in version 10.0.0.

Gets or sets the content-encryption key length, in bits, used when creating CMS/PKCS #7 encrypted MIME. The permitted value depends on Pkcs7CryptAlg.

Gets or sets the protocol parameter of the Content-Type header field. This parameter is commonly used by multipart/signed to identify the media type of the detached signature part.

Content-Type: multipart/signed;
  protocol="application/pkcs7-signature";
  micalg=sha-256;
  boundary="example-boundary"

Gets or sets the RSA signature scheme used when creating CMS/PKCS #7 signed MIME. The default is PKCS1-v1_5. Set the property to RSASSA-PSS or pss to use RSASSA-PSS.

This setting applies only when the signing private key is RSA. It does not select the signature scheme for EC or DSA keys. The property controls signature creation and is not updated during verification; use GetLastJsonData to inspect a verified signature.

Gets or sets the message-digest algorithm used when creating CMS/PKCS #7 signatures. Supported values are sha1, sha256, sha384, sha512, md5, and md2.

This property controls signature creation only. It is not changed when a signature is verified. After verification, call GetLastJsonData to inspect the algorithms found in the signed data.

Gets or sets a semicolon-delimited or implementation-specific option string used for uncommon compatibility requirements. The default is the empty string, and normal applications should leave it empty. Options placed here may be version-specific and should be used only when directed by Chilkat documentation or support.

Controls whether UnwrapSecurity adds informative header fields describing the security layers that were removed. The default behavior should normally be retained unless the application requires a minimally modified unwrapped MIME message.

Controls whether Chilkat uses the conventional multipart preamble text This is a multi-part message in MIME format. when serializing a multipart entity. The default is FALSE. The preamble is meaningful only when the multipart has content and is ignored by MIME-aware readers.

Controls whether newly created S/MIME media types use the historical x-pkcs7 names.

When set to TRUE, all const char * arguments and return values are interpreted as UTF-8 strings. When set to FALSE, they are interpreted as ANSI strings.

In Chilkat v11.0.0 and later, the default value is TRUE. Before v11.0.0, it was FALSE.

If set to TRUE, then the contents of LastErrorText (or LastErrorXml, or LastErrorHtml) may contain more verbose information. The default value is FALSE. Verbose logging should only be used for debugging. The potentially large quantity of logged information may adversely affect peformance.

Version of the component/library, such as "10.1.0"

Computes the byte length of the current entity's serialized MIME body and adds or updates its Content-Length header. The count is based on the transfer-encoded serialized body, not the decoded payload.

For a multipart entity, the count includes boundary delimiter lines, child headers, child bodies, and the closing boundary. Only the current entity's header is updated; child parts do not receive Content-Length fields. Repeated calls recompute the value and leave a single header occurrence.

Adds cert to the internal collection of certificates available for S/MIME decryption. The certificate must have access to its corresponding private key. Call this method once for each candidate certificate.

The collection is searched by decryption methods such as Decrypt and UnwrapSecurity. Other ways to provide decryption credentials include AddPfxSourceFile, AddPfxSourceBd, and UseCertVault.

Returns TRUE for success, FALSE for failure.

Creates an S/MIME detached signature using cert. The certificate must have access to its private key. On success, the current object becomes a multipart/signed entity with two direct children:

Use SigningHashAlg and, for RSA keys, SigningAlg to select the signing algorithms.

Returns TRUE for success, FALSE for failure.

Creates the same detached multipart/signed structure as AddDetachedSignature, with transferHeaderFields controlling whether the calling object's header fields are transferred to the first, signed content part while the outer multipart wrapper is created.

cert is the signing certificate and must have access to its private key.

Returns TRUE for success, FALSE for failure.

Creates a detached S/MIME signature using cert as the signer certificate and privateKey as its associated private key. Use this method when the certificate and private key are supplied separately rather than combined in a PFX/P12 file or certificate object.

On success, the current object is transformed into the same two-part multipart/signed structure described by AddDetachedSignature.

Returns TRUE for success, FALSE for failure.

Creates a detached S/MIME signature using the certificate in cert and the corresponding private key in privateKey. transferHeaderFields controls whether the calling object's header fields are transferred to the first, signed content part while the outer multipart/signed wrapper is created.

This is the separate-private-key counterpart of AddDetachedSignature2.

Returns TRUE for success, FALSE for failure.

Adds cert to the internal recipient-certificate list used by EncryptN. Call this method once for each intended recipient. Encryption uses the public key in each certificate, so recipient private keys are not required at encryption time.

Call ClearEncryptCerts to empty the list.

Returns TRUE for success, FALSE for failure.

Appends a new header field named by name with the value in value. Existing fields having the same case-insensitive name are preserved. An empty value creates a legal empty-valued field.

Chilkat converts spaces in a header name to hyphens, removes embedded CR and LF characters from the value to prevent header injection, and folds long values when serializing.

Returns TRUE for success, FALSE for failure.

Adds the PKCS #12/PFX bytes in bd to the internal collection of credential sources. password is the password protecting the PFX data. Call the method once for each PFX source that should be searched by later decryption or signing operations.

Returns TRUE for success, FALSE for failure.

Adds the PFX/P12 file at the local filesystem path in pfxFilePath to the internal collection of credential sources. password is the password protecting the file. Call the method once for each PFX source that should be searched.

Returns TRUE for success, FALSE for failure.

Appends a copy of mime as the last direct child. Chilkat does not retain a reference to mime, so later changes to mime do not affect the appended part. The same source object may be appended more than once.

If the current object is not multipart, it is converted to multipart/mixed. The complete original entity, including its existing headers and body, becomes part 0; the copy of mime becomes part 1. The new outer entity contains its generated multipart Content-Type.

Returns TRUE for success, FALSE for failure.

Reads the local file at filename, creates an attachment part, and appends it. Filename-extension matching is case-insensitive.

If the current object is not multipart, the same conversion described by AppendPart occurs. Calling this method on a new empty object therefore creates an empty part 0 and the file attachment as part 1.

Returns TRUE for success, FALSE for failure.

Parses the current part's decoded body as ASN.1 DER and returns an XML representation of the ASN.1 structure. This is primarily useful for inspecting CMS/PKCS #7 bodies such as application/pkcs7-mime or application/x-pkcs7-mime.

Content-Type: application/pkcs7-mime; smime-type=signed-data
Content-Transfer-Encoding: base64

MII...

Returns TRUE for success, FALSE for failure.

Clears the internal recipient-certificate list populated by AddEncryptCert. A subsequent call to EncryptN requires certificates to be added again.

Returns TRUE if the currently visible MIME tree contains a CMS/PKCS #7 encrypted part.

Returns TRUE if the currently visible MIME tree contains a detached or opaque CMS/PKCS #7 signed part.

Recursively converts every part whose Content-Transfer-Encoding is 8bit or binary to base64. Both the child object's Encoding property and the serialized header are updated. Parts using 7bit or another encoding are unchanged.

Wraps the current entity in a new outer multipart/alternative entity. The original entity becomes the first and initially only child.

The new outer entity retains message-level and custom headers such as MIME-Version, Date, Subject, From, To, Content-ID, Content-Location, and custom fields. The original Content-Type, Content-Transfer-Encoding, Content-Disposition, and body move to the first child. An existing charset parameter is retained on the new multipart Content-Type. Calling the method again wraps the existing multipart in another multipart layer; the operation is not idempotent.

Returns TRUE for success, FALSE for failure.

Wraps the current entity in a new outer multipart/mixed entity. The original entity becomes the first and initially only child.

The new outer entity retains message-level and custom headers such as MIME-Version, Date, Subject, From, To, Content-ID, Content-Location, and custom fields. The original Content-Type, Content-Transfer-Encoding, Content-Disposition, and body move to the first child. An existing charset parameter is retained on the new multipart Content-Type. Calling the method again wraps the existing multipart in another multipart layer; the operation is not idempotent.

Returns TRUE for success, FALSE for failure.

Creates an opaque (attached) S/MIME signature using cert. The certificate must have access to its private key. On success, the current MIME entity is replaced by CMS/PKCS #7 signed-data containing both the original MIME bytes and the signature.

This differs from AddDetachedSignature, which creates a visible multipart/signed wrapper with a separate signature part.

Returns TRUE for success, FALSE for failure.

Creates an opaque (attached) S/MIME signature using cert as the signer certificate and privateKey as its associated private key. Use this method when the certificate and private key are supplied separately.

The resulting CMS/PKCS #7 signed-data contains the original MIME entity and its signature. For a detached multipart/signed result, use AddDetachedSignaturePk.

Returns TRUE for success, FALSE for failure.

Decrypts the current CMS/PKCS #7 encrypted MIME entity and replaces it with the recovered MIME content. Chilkat identifies the intended recipient from the CMS recipient information and searches the configured credential sources for the matching certificate and private key.

Returns TRUE for success, FALSE for failure.

Decrypts the current CMS/PKCS #7 encrypted MIME entity using the certificate in cert and its associated private key in privateKey. On success, the current object is replaced by the recovered MIME content.

Use this method when the certificate and private key are stored separately. Use Decrypt when Chilkat should locate the credential from configured sources.

Returns TRUE for success, FALSE for failure.

Decrypts the current CMS/PKCS #7 encrypted MIME entity using cert. The certificate must have access to its corresponding private key. On success, the encrypted wrapper is replaced by the recovered MIME content.

Returns TRUE for success, FALSE for failure.

Decrypts the current CMS/PKCS #7 encrypted MIME entity using certificates and private keys from the PFX/P12 file at the local filesystem path in pfxFilePath. pfxPassword is the password protecting the file.

On success, the encrypted wrapper is replaced by the recovered MIME content.

Returns TRUE for success, FALSE for failure.

Encrypts the current MIME entity for the recipient certificate in cert and replaces it with CMS/PKCS #7 encrypted S/MIME. Only the recipient's public key is needed to encrypt; the corresponding private key is required later to decrypt.

The content-encryption algorithm is selected by Pkcs7CryptAlg and Pkcs7KeyLength. For RSA recipients, OaepPadding, OaepHash, and OaepMgfHash control key transport.

Returns TRUE for success, FALSE for failure.

Encrypts the current MIME entity for every certificate previously added with AddEncryptCert. Each recipient receives independently protected access to the same encrypted content.

Add one certificate per intended recipient, call this method, and use ClearEncryptCerts before preparing a different recipient set.

Returns TRUE for success, FALSE for failure.

Replaces the contents of binDat with the decoded body bytes of the current part. Existing bytes in binDat are discarded. Base64 and quoted-printable are decoded. MIME headers, multipart boundaries, and child parts are not included.

Returns TRUE for success, FALSE for failure.

Returns the decoded body as text. Chilkat first decodes the Content-Transfer-Encoding and then interprets text according to the declared charset.

Returns TRUE for success, FALSE for failure.

Returns the current part's transfer-encoded body text without decoding Base64 or quoted-printable. The returned value is Chilkat's normalized serialization of the body, not necessarily the exact text that appeared in the loaded MIME. For example, Base64 padding and line wrapping or quoted-printable spelling may be regenerated.

Returns TRUE for success, FALSE for failure.

Examines the current encrypted S/MIME entity and writes information about the required recipient certificate or certificates to the JsonObject in certInfo. This can be used to identify which certificate and private key must be made available before calling Decrypt or UnwrapSecurity.

Returns TRUE for success, FALSE for failure.

Returns the complete serialized body of the current MIME entity. For multipart MIME, this includes boundary delimiters, each child part's headers and body, and the closing boundary. The current entity's own header fields are not included.

Use GetBodyDecoded when the decoded payload of a single part is needed.

Returns TRUE for success, FALSE for failure.

Returns the complete serialized header section of the current MIME entity. The body and any multipart child content are not included.

Returns TRUE for success, FALSE for failure.

Returns the value of the first header field whose name matches fieldName case-insensitively. Duplicate later occurrences are not combined. Returns null when no matching field exists.

Returns TRUE for success, FALSE for failure.

Returns an attribute value parsed from the first header field named by name. Both the header name and attrName attribute name are matched case-insensitively. Surrounding quotation marks are removed, and semicolons inside a quoted value are handled as part of the value.

Extended parameters such as filename*=utf-8''r%C3%A9sum%C3%A9.txt are returned in their raw encoded form; this method does not percent-decode or apply the declared charset. Returns null when the field or attribute is absent.

Returns TRUE for success, FALSE for failure.

Returns the name of the header-field occurrence at zero-based index. Header order and original casing are preserved for ordinary loaded headers. Use NumHeaderFields to determine the valid range.

Returns TRUE for success, FALSE for failure.

Returns the unfolded value of the header-field occurrence at zero-based index. Continuation lines are combined into a single value. Use NumHeaderFields to determine the valid range.

Returns TRUE for success, FALSE for failure.

Copies structured details from the most recent operation into json when such details are available. Many methods do not produce JSON data. Methods involving CMS/PKCS #7 security, such as UnwrapSecurity, may report algorithms, certificates, recipients, signatures, and validation results.

Serializes and returns the complete MIME entity, including headers, body, multipart boundaries, and all descendants.

Returns TRUE for success, FALSE for failure.

Serializes the complete MIME entity and appends its bytes to bindat. Existing BinData bytes are preserved. Use this method when arbitrary binary body bytes must not pass through a text string.

Returns TRUE for success, FALSE for failure.

Serializes the complete MIME entity and appends it to sb. Existing StringBuilder content is preserved.

Returns TRUE for success, FALSE for failure.

Returns the CMS signingTime signed attribute for the signer at zero-based index, formatted as an RFC 822-style date string. For example:

Fri, 21 Nov 1997 09:55:06 -0600

Call HasSignatureSigningTime first because the attribute is optional. Use NumSignerCerts for the signer count.

Returns TRUE for success, FALSE for failure.

Returns a concise MIME-tree summary. fmt is case-insensitive. The value xml selects XML output; all other values, including text, an empty string, or an unrecognized value, select the indented text format.

multipart/mixed
    text/plain
    application/octet-stream

<multipart-mixed>
    <text-plain />
    <application-octet-stream />
</multipart-mixed>

Returns TRUE for success, FALSE for failure.

Converts the MIME tree to Chilkat's XML representation and returns it as a string. Header names become XML element names, structured header parameters become XML attributes, duplicate headers become repeated elements, multipart children are nested in subpart elements, and binary bodies are represented in an encoded textual form.

Returns TRUE for success, FALSE for failure.

Returns TRUE if the signer at zero-based index has a CMS signingTime signed attribute. Use NumSignerCerts for the signer count and GetSignatureSigningTimeStr to retrieve the value.

Returns TRUE when ContentType begins with application/. It returns FALSE for an empty or malformed media type.

Returns TRUE when the current part's disposition value is attachment, matched case-insensitively. Parameters such as filename do not affect the test. An inline part remains non-attachment even when it has a filename.

Returns TRUE when ContentType begins with audio/.

Returns TRUE when the current MIME entity is a CMS/PKCS #7 encrypted S/MIME wrapper. To search the visible MIME tree rather than only the current entity, use ContainsEncryptedParts.

Returns TRUE when ContentType is text/html. The ContentType property must contain only the media type; set parameters such as charset separately.

Returns TRUE when ContentType begins with image/, including values such as image/svg+xml.

Returns TRUE when ContentType begins with multipart/.

Returns TRUE when ContentType is multipart/alternative.

Returns TRUE when ContentType is multipart/mixed.

Returns TRUE when ContentType is multipart/related.

Returns TRUE when ContentType is text/plain.

Returns TRUE when the current MIME entity is a CMS/PKCS #7 signed S/MIME wrapper, including detached multipart/signed and opaque signed-data forms. To search the visible MIME tree, use ContainsSignedParts.

Returns TRUE when ContentType begins with text/.

Returns TRUE when ContentType begins with video/.

Returns TRUE only for text/xml or application/xml. It does not classify structured-suffix media types such as application/soap+xml, application/atom+xml, or image/svg+xml as XML.

Loads into cert the decryption certificate at zero-based index from the most recent security-unwrapping operation. Valid indexes range from 0 through NumDecryptCerts - 1.

Returns TRUE for success, FALSE for failure.

Loads into cert the signer certificate at zero-based index from the most recent signature-verification or security-unwrapping operation. Valid indexes range from 0 through NumSignerCerts - 1.

Returns TRUE for success, FALSE for failure.

Parses the complete MIME text in mimeMsg and replaces the current object's headers, body, and multipart tree. A successful call always replaces the previous MIME.

If no blank line separates headers from the body, lines that appear header-like are parsed as headers and the body is empty. Data after the header/body separator belongs to the body.

Returns TRUE for success, FALSE for failure.

Parses complete MIME bytes from bindat and replaces the current MIME on success. This is the preferred loader when the MIME can contain arbitrary 8-bit body bytes or embedded NUL bytes. Parsing tolerance and serialization normalization are the same as LoadMime.

Returns TRUE for success, FALSE for failure.

Reads and parses the complete MIME entity from the local file at fileName. A successful call replaces the current MIME. If the file cannot be opened, the method returns FALSE and preserves the existing object unchanged.

Parsing tolerance and serialization normalization are the same as LoadMime.

Returns TRUE for success, FALSE for failure.

Parses complete MIME text from sb and replaces the current MIME on success. Parsing tolerance and serialization normalization are the same as LoadMime.

Returns TRUE for success, FALSE for failure.

Reconstructs a MIME tree from Chilkat's MIME XML in xml. On success, the current object is replaced. If the XML is invalid, the method returns FALSE and preserves the existing MIME unchanged.

The reconstructed MIME is semantically equivalent but not byte-identical to the MIME that produced the XML. Header names are normalized to lowercase.

Returns TRUE for success, FALSE for failure.

Reads Chilkat MIME XML from the local file at fileName and reconstructs the MIME tree. On success, the current object is replaced. If the file cannot be opened or the XML is invalid, the method returns FALSE and preserves the existing MIME unchanged. Header names are normalized to lowercase during reconstruction.

Returns TRUE for success, FALSE for failure.

Clears the current object and initializes it as message/rfc822. Its body is a serialized copy of mimeObject at the time of the call. Later modifications to mimeObject do not change the embedded message.

Returns TRUE for success, FALSE for failure.

Initializes an empty multipart/alternative entity. Clears all existing headers, body content, and child parts. The new object contains only a multipart Content-Type with an automatically generated boundary, has zero parts, and does not automatically add MIME-Version.

Returns TRUE for success, FALSE for failure.

Initializes an empty multipart/mixed entity. Clears all existing headers, body content, and child parts. The new object contains only a multipart Content-Type with an automatically generated boundary, has zero parts, and does not automatically add MIME-Version.

Returns TRUE for success, FALSE for failure.

Initializes an empty multipart/related entity. Clears all existing headers, body content, and child parts. The new object contains only a multipart Content-Type with an automatically generated boundary, has zero parts, and does not automatically add MIME-Version.

Returns TRUE for success, FALSE for failure.

Provides live access to the direct child at zero-based index through subPart. Modifying subPart after a successful call modifies the child stored in the parent MIME tree.

Valid indexes range from 0 through NumParts - 1. An invalid index returns FALSE and preserves subPart unchanged.

Returns TRUE for success, FALSE for failure.

Recursively traverses the MIME tree and saves each part having a nonempty filename parameter to the existing directory in path. A name parameter alone is not used as a fallback. The disposition may be attachment or inline; a filename is what controls extraction.

• Only the final path component of a MIME filename is used. Directory components, absolute paths, and .. traversal are discarded.
• On Windows, invalid filename characters are replaced with underscores.
• Duplicate filenames target the same path; later parts overwrite earlier parts.
• st is appended to rather than cleared. Each added entry is the full path actually written, including any sanitized filename.
• The destination directory is not created. If it does not exist, the method returns FALSE, creates no files, and appends nothing to st.

Returns TRUE for success, FALSE for failure.

Removes fields whose name matches fieldName case-insensitively. If bAllOccurrences is FALSE, only the first matching occurrence is removed. If bAllOccurrences is TRUE, all matching occurrences are removed. Remaining fields retain their relative order.

Removes the direct child at zero-based index. Valid indexes range from 0 through NumParts - 1. An out-of-range index returns FALSE and leaves the tree unchanged.

Returns TRUE for success, FALSE for failure.

Writes the decoded body bytes of the current part to the local path in filename. Base64 and quoted-printable are decoded. MIME headers and multipart framing are not written.

Returns TRUE for success, FALSE for failure.

Serializes the complete MIME entity and writes it to the local path in filename, including headers, body, multipart boundaries, and all descendants.

Returns TRUE for success, FALSE for failure.

Writes Chilkat's MIME XML representation to the local path in filename. The file can be loaded by LoadXmlFile.

Returns TRUE for success, FALSE for failure.

Sets the current part's body from str while preserving existing content headers such as Content-Type, charset, and Content-Transfer-Encoding.

Sets the decoded body bytes from bd, changes Content-Transfer-Encoding to base64, and preserves the bytes exactly. It does not set a Content-Type, disposition, filename, or name; set those separately when needed.

Returns TRUE for success, FALSE for failure.

Sets the body from transfer-encoded text. encoding must be base64 or quoted-printable; other values, including 7bit, 8bit, binary, an unknown name, or an empty string, cause failure.

Base64 whitespace is accepted and the stored representation is normalized. Invalid Base64 causes the method to return FALSE. On any failure, all existing headers and body content are preserved unchanged.

Returns TRUE for success, FALSE for failure.

Reads the local file at fileName and replaces the current part's body and content headers according to the filename extension.

If the file cannot be opened, the method returns FALSE and preserves the existing MIME unchanged.

Returns TRUE for success, FALSE for failure.

Sets str as HTML and changes the media type to text/html. For ASCII input, Chilkat uses Content-Transfer-Encoding: 7bit and does not add a charset. Existing unrelated headers are preserved.

Returns TRUE for success, FALSE for failure.

Sets str as plain text. For ASCII input, Chilkat sets Content-Type: text/plain; format=flowed and Content-Transfer-Encoding: 7bit without a charset. For non-ASCII UTF-8 input, it sets charset=utf-8 and uses 8bit. Existing unrelated headers are preserved.

Returns TRUE for success, FALSE for failure.

Sets str as XML, changes the media type to text/xml, and selects a transfer encoding appropriate for the text. For ASCII input, Chilkat uses 7bit and does not add a charset.

The XML declaration's encoding value is not copied to the MIME charset parameter.

Returns TRUE for success, FALSE for failure.

Sets one header field named by name. Matching is case-insensitive. All existing occurrences are removed and one replacement is inserted. If no field exists, a new one is added. Passing an empty value removes all matching occurrences rather than creating an empty-valued field.

Use AddHeaderField to append another occurrence or to create an empty-valued field.

Returns TRUE for success, FALSE for failure.

Sets cert as an explicitly supplied signer certificate for subsequent signature verification. This is useful when the CMS/PKCS #7 signature does not embed the signer certificate or when the application must require a particular certificate.

The certificate's public key is used for verification; a private key is not required.

Returns TRUE for success, FALSE for failure.

Recursively removes all visible S/MIME security layers from the MIME tree. It decrypts encrypted parts and verifies detached or opaque signatures, continuing through nested layers until no additional supported security wrapper remains.

On success, the object contains the original MIME structure and content from before signing and encryption. The method returns TRUE only when every required decryption and signature verification succeeds.

Returns TRUE for success, FALSE for failure.

Replaces the current body with an application/x-www-form-urlencoded-style representation using the character set named by charset. Spaces become +, a literal plus becomes %2B, non-ASCII bytes become %HH sequences, and separators such as & and = remain unchanged.

Input:  a b+c&d=e
Output: a+b%2Bc&d=e

The MIME content headers are not changed. If the named character set is unsupported, the body remains unchanged.

Sets vault as the certificate vault used to locate certificates and private keys for S/MIME encryption, decryption, signing, and verification. Only one vault is active; each call replaces the previously configured vault.

Use XmlCertVault when credentials are maintained independently of platform certificate stores or individual PFX sources.

Returns TRUE for success, FALSE for failure.

Verifies the current CMS/PKCS #7 signed MIME entity and removes the signature wrapper. Both detached multipart/signed messages and opaque CMS signed-data are supported. On success, the object is restored to the MIME structure and content that was signed.

The signer certificate is commonly embedded in the signature. If it is absent, Chilkat searches configured or platform certificate sources, or uses a certificate supplied by SetVerifyCert.

Returns TRUE for success, FALSE for failure.

Deprecated. Use NumDecryptCerts instead.

Returns the number of decryption certificates recorded by the most recent S/MIME security-unwrapping operation. The property is populated by UnwrapSecurity.

Legacy byte-array method. Adds the PKCS #12/PFX data in pfxFileData to the internal collection of credential sources. pfxPassword is the password protecting the PFX. Call the method once for each PFX source that should be searched.

Prefer AddPfxSourceBd when a BinData object is available.

Returns TRUE for success, FALSE for failure.

Legacy byte-array method. Decrypts the current CMS/PKCS #7 encrypted MIME entity using certificates and private keys from the PFX/P12 bytes in pfxData. password is the password protecting the PFX data.

On success, the encrypted wrapper is replaced by the recovered MIME content.

Returns TRUE for success, FALSE for failure.

Deprecated. Applications should call PartsToFiles.

This method recursively saves parts having a nonempty filename parameter to the existing directory in dirPath and returns a StringArray containing the created paths. See PartsToFiles for the current extraction and filename-handling rules.

Returns NULL on failure

Deprecated. Use the certificate object's GetIssuer method instead.

Finds the issuer of cert. If cert is self-issued or a root certificate, the returned object is a copy of cert.

Returns NULL on failure

Returns the decoded body bytes of the current part. Base64 and quoted-printable are decoded, but no MIME headers or multipart framing are included. This legacy byte-array method preserves arbitrary bytes, including embedded NUL bytes.

Returns TRUE for success, FALSE for failure.

Deprecated. Use LastDecryptCert instead.

Returns the certificate at zero-based index from the certificates recorded by the most recent decryption operation. Use NumDecryptCerts for the count.

Returns NULL on failure

Returns the complete serialized MIME entity as a byte array. This preserves binary body bytes that cannot safely pass through a string.

Returns TRUE for success, FALSE for failure.

This method is deprecated. Applications should call PartAt.

Retrieves the direct child at zero-based index. The returned object provides live access to the child stored in the parent MIME tree, so modifying it modifies the parent.

Returns NULL on failure

Deprecated. Use LastSignerCert instead.

Returns the signer certificate at zero-based index from the most recent verification or security-unwrapping operation.

Returns NULL on failure

Deprecated. Retrieve the signer certificate with LastSignerCert and then obtain its certificate chain through the Cert API.

This method returns the chain associated with the signer at zero-based index.

Returns NULL on failure

Deprecated. Use GetLastJsonData instead.

Returns a JsonObject containing details produced by the most recent operation when that operation provides structured diagnostic data. For example, after UnwrapSecurity, the JSON may describe the signature, key-transport, content-encryption, and certificate information encountered.

Returns NULL on failure

Parses complete MIME bytes from binData and replaces the current MIME on success. This byte-oriented loader preserves arbitrary 8-bit values and embedded NUL bytes. Parsing tolerance and serialization normalization are the same as LoadMime.

Returns TRUE for success, FALSE for failure.

Legacy byte-array method. Sets the decoded body bytes from binData, changes Content-Transfer-Encoding to base64, and preserves the bytes exactly. It does not set a Content-Type, disposition, filename, or name; set those separately when needed. Prefer SetBodyBd when using BinData.

Returns TRUE for success, FALSE for failure.