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 default is an empty string, which selects normal behavior. A valid empty JSON object may also be supplied as {}.

Unknown JSON members are retained but ignored. Malformed JSON is normalized to {}. 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: 1 means success, 0 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 recipient or decryption certificates currently recorded by the most recent S/MIME encryption, decryption, or security-unwrapping operation. A new object returns 0. A successful single-recipient Encrypt records 1, and successful decryption records the certificate whose private key was used.

Use LastDecryptCert with a zero-based index to retrieve a recorded certificate. This is a result count; it is not the number of PFX sources or decryption certificates configured on the object.

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 currently recorded by the most recent S/MIME signing, signature-verification, or security-unwrapping operation. A new object returns 0. A single-certificate signing method records 1; Verify and UnwrapSecurity replace the count with the signer results from that operation.

A failed call to Verify clears the signer results and sets this property to 0. Use LastSignerCert with a zero-based index to retrieve a recorded signer certificate.

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. The default is sha256. An empty or unrecognized value leaves the current valid setting unchanged.

This property is used only when OaepPadding is 1. It is independent of OaepMgfHash; for example, OAEP may use SHA-256 while MGF1 uses SHA-1.

Gets or sets the hash algorithm used by the MGF1 mask generation function within RSAES-OAEP. Supported values are sha1, sha256, sha384, and sha512. The default is sha256. An empty or unrecognized value leaves the current valid setting unchanged.

This property is used only when OaepPadding is 1 and is independent of OaepHash.

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

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

The getter returns normalized names: after setting aes-gcm it returns aes, and after setting 3des it returns des. The generated CMS data nevertheless uses AES-GCM or 3DES-CBC respectively.

Gets or sets the content-encryption key length, in bits, used when creating CMS/PKCS #7 encrypted MIME. The default is 128.

Because this property may be set before Pkcs7CryptAlg, the setter accepts the union of key lengths that can be valid for any supported symmetric algorithm: 40, 56, 64, 128, 192, and 256. A value outside this set is rejected and the previous value is retained.

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 and normalized PKCS #1 v1.5 value is PKCS1-V1_5. Set the property to RSASSA-PSS or pss to use RSASSA-PSS; the getter returns RSASSA-PSS.

An empty or unrecognized value selects PKCS1-V1_5. 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. The default is sha256. Supported values are sha1, sha256, sha384, sha512, md5, and md2. Names are case-insensitive and are returned in lowercase.

An empty or unrecognized value selects sha1. This property controls signature creation only and is not changed when a signature is verified. After verification, call GetLastJsonData to inspect the digest algorithm 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 removed. The default is 1.

Set to 0 when the application requires the unwrapped MIME without these additional status headers.

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 0. 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.

For detached signatures, the selected signature media type is used both for the outer protocol parameter and for the signature part. For opaque signed or encrypted MIME, it controls the application/...pkcs7-mime content type.

When set to 1, all string arguments and return values are interpreted as UTF-8 strings. When set to 0, they are interpreted as ANSI strings.

In Chilkat v11.0.0 and later, the default value is 1. Before v11.0.0, it was 0.

If set to 1, then the contents of LastErrorText (or LastErrorXml, or LastErrorHtml) may contain more verbose information. The default value is 0. 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 Decrypt and UnwrapSecurity. Other ways to provide decryption credentials include AddPfxSourceFile, AddPfxSourceBd, and UseCertVault.

Returns 1 for success, 0 for failure.

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

SigningHashAlg selects the digest and generated micalg parameter. For RSA keys, SigningAlg selects PKCS #1 v1.5 or RSASSA-PSS. UseXPkcs7 selects the signature media-type spelling.

Returns 1 for success, 0 for failure.

Creates the same detached multipart/signed structure as AddDetachedSignature. cert is the signing certificate and must have access to its private key.

Returns 1 for success, 0 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.

On success, the current object becomes the same two-part multipart/signed structure described by AddDetachedSignature. SigningHashAlg, SigningAlg, and UseXPkcs7 control the generated signature.

Returns 1 for success, 0 for failure.

Creates a detached S/MIME signature using the certificate in cert and the corresponding private key in privateKey. transferHeaderFields controls placement of the existing message header fields:

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

Returns 1 for success, 0 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 1 for success, 0 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 1 for success, 0 for failure.

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

The source remains configured across subsequent LoadMime calls and repeated decryptions. Chilkat continues searching after a PFX that does not contain the required recipient key.

Returns 1 for success, 0 for failure.

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

The source remains configured across subsequent LoadMime calls and repeated decryptions. Chilkat continues searching after a PFX that does not contain the required recipient key.

Returns 1 for success, 0 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 1 for success, 0 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 1 for success, 0 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 1 for success, 0 for failure.

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

Returns 1 if the currently visible MIME tree contains a CMS/PKCS #7 encrypted entity. Both application/pkcs7-mime and application/x-pkcs7-mime forms are recognized.

Returns 1 if the currently visible MIME tree contains a complete detached or opaque CMS/PKCS #7 signed entity. A standalone application/pkcs7-signature or application/x-pkcs7-signature leaf part is not by itself classified as a signed message.

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 1 for success, 0 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 1 for success, 0 for failure.

Creates an opaque (attached) S/MIME signature using cert. The certificate itself 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.

The result has no MIME child parts, uses Base64 content-transfer encoding, and has an application/x-pkcs7-mime or application/pkcs7-mime content type according to UseXPkcs7. SigningHashAlg and, for RSA keys, SigningAlg select the signing algorithms.

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

Returns 1 for success, 0 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, has no MIME child parts, and uses Base64 content-transfer encoding. For a detached multipart/signed result, use AddDetachedSignaturePk.

Returns 1 for success, 0 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 configured credential sources for the matching certificate and private key.

On success, NumDecryptCerts and LastDecryptCert identify the certificate used, and GetLastJsonData reports the content-encryption algorithm and key size. On failure, the encrypted MIME remains unchanged.

Returns 1 for success, 0 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 encrypted wrapper is replaced by the recovered MIME content, the decryption certificate is available through LastDecryptCert, and operation details are available through GetLastJsonData. On failure, the encrypted MIME remains unchanged.

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

Returns 1 for success, 0 for failure.

Decrypts the current CMS/PKCS #7 encrypted MIME entity using cert. The certificate must have access to its corresponding private key; a public-only certificate is insufficient. On success, the encrypted wrapper is replaced by the recovered MIME content and cert is recorded in the decryption results. On failure, the encrypted MIME remains unchanged.

Returns 1 for success, 0 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 and the matching certificate is available through LastDecryptCert. GetLastJsonData may include both CMS decryption details and information produced while reading the PFX. On failure, the encrypted MIME remains unchanged.

Returns 1 for success, 0 for failure.

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

The default content encryption is AES-128-CBC. Pkcs7CryptAlg and Pkcs7KeyLength select the symmetric algorithm and key length. By default, RSAES-PKCS1-v1_5 transports the content-encryption key; set OaepPadding to 1 to use RSAES-OAEP, with OaepHash and OaepMgfHash controlling its parameters.

The generated MIME uses Base64 transfer encoding, the filename smime.p7m, and an application/x-pkcs7-mime or application/pkcs7-mime content type according to UseXPkcs7. After encryption, GetDecryptCertInfo can report the recipient identifiers stored in the CMS data. If encryption fails, the original MIME remains unchanged.

Returns 1 for success, 0 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 1 for success, 0 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 1 for success, 0 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 1 for success, 0 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 1 for success, 0 for failure.

Examines the current encrypted S/MIME entity and writes recipient-certificate identifiers 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. A typical result is:

{
  "recipientInfo": [
    {
      "serial": "166FC256FC66A64B20C710F15BFAB63E",
      "issuerCN": "Example Issuing CA"
    }
  ]
}

The method returns 0 and writes an empty JSON object when the current MIME entity is not encrypted, including after it has already been decrypted.

Returns 1 for success, 0 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 1 for success, 0 for failure.

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

Returns 1 for success, 0 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 1 for success, 0 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 1 for success, 0 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 1 for success, 0 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 1 for success, 0 for failure.

Copies structured details from the most recent operation into json when such details are available. Many methods do not produce JSON data.

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

Returns 1 for success, 0 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 1 for success, 0 for failure.

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

Returns 1 for success, 0 for failure.

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

Wed, 29 Jul 2026 14:32:58 GMT

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

Returns 1 for success, 0 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 1 for success, 0 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 1 for success, 0 for failure.

Returns 1 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 1 when ContentType begins with application/. It returns 0 for an empty or malformed media type.

Returns 1 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 1 when ContentType begins with audio/.

Returns 1 when the current MIME entity is a CMS/PKCS #7 encrypted S/MIME wrapper. Both application/pkcs7-mime and application/x-pkcs7-mime forms are recognized. To search the visible MIME tree rather than only the current entity, use ContainsEncryptedParts.

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

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

Returns 1 when ContentType begins with multipart/.

Returns 1 when ContentType is multipart/alternative.

Returns 1 when ContentType is multipart/mixed.

Returns 1 when ContentType is multipart/related.

Returns 1 when ContentType is text/plain.

Returns 1 when the current MIME entity is a complete CMS/PKCS #7 signed S/MIME wrapper, including detached multipart/signed and opaque signed-data forms. A standalone application/pkcs7-signature or application/x-pkcs7-signature leaf part is not by itself classified as a signed message. To search the visible MIME tree, use ContainsSignedParts.

Returns 1 when ContentType begins with text/.

Returns 1 when ContentType begins with video/.

Returns 1 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 successful decryption or security-unwrapping operation. Valid indexes range from 0 through NumDecryptCerts - 1. The returned certificate has access to the private key used for decryption.

An invalid index returns 0 and leaves cert unchanged.

Returns 1 for success, 0 for failure.

Loads into cert the signer certificate at zero-based index from the most recent successful signature-verification or security-unwrapping operation. Valid indexes range from 0 through NumSignerCerts - 1. The returned certificate normally contains only the public key; it does not gain access to the signer's private key.

An invalid index returns 0 and leaves cert unchanged. A later failed call to Verify clears the signer results.

Returns 1 for success, 0 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 1 for success, 0 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 1 for success, 0 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 0 and preserves the existing object unchanged.

Parsing tolerance and serialization normalization are the same as LoadMime.

Returns 1 for success, 0 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 1 for success, 0 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 0 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 1 for success, 0 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 0 and preserves the existing MIME unchanged. Header names are normalized to lowercase during reconstruction.

Returns 1 for success, 0 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 1 for success, 0 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 1 for success, 0 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 1 for success, 0 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 1 for success, 0 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 0 and preserves subPart unchanged.

Returns 1 for success, 0 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 0, creates no files, and appends nothing to st.

Returns 1 for success, 0 for failure.

Removes fields whose name matches fieldName case-insensitively. If bAllOccurrences is 0, only the first matching occurrence is removed. If bAllOccurrences is 1, 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 0 and leaves the tree unchanged.

Returns 1 for success, 0 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 1 for success, 0 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 1 for success, 0 for failure.

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

Returns 1 for success, 0 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 1 for success, 0 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 0. On any failure, all existing headers and body content are preserved unchanged.

Returns 1 for success, 0 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 0 and preserves the existing MIME unchanged.

Returns 1 for success, 0 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 1 for success, 0 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 1 for success, 0 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 1 for success, 0 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 1 for success, 0 for failure.

Supplies cert as a signer-certificate fallback for subsequent signature verification. This is useful when the CMS/PKCS #7 signature does not embed the signer certificate and Chilkat cannot otherwise locate it. Only the public key is required.

Returns 1 for success, 0 for failure.

Removes supported S/MIME security layers and restores the underlying MIME content. It handles both common layer orders: a message signed and then encrypted, and a message encrypted and then signed. It continues through nested top-level layers until no additional supported security wrapper remains.

After a successful call, NumSignerCerts and LastSignerCert identify verified signers, while NumDecryptCerts and LastDecryptCert identify decryption certificates. GetLastJsonData may contain both pkcs7.verify and pkcs7.decrypt details.

Returns 1 for success, 0 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 1 for success, 0 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. The method works with signed MIME loaded from serialized input as well as MIME signed by the current object.

On success, the object is restored to the MIME structure and content that was signed, NumSignerCerts reports the verified signer count, LastSignerCert returns the signer certificate, and GetLastJsonData reports CMS verification details. A detached signature can restore the original serialization exactly, but opaque signed-data restoration is semantic and is not guaranteed to reproduce byte-for-byte identical MIME serialization.

On failure, the signed wrapper remains unchanged, no content is unwrapped, and the signer-result count is cleared to 0.

Returns 1 for success, 0 for failure.

Deprecated. Use NumDecryptCerts instead.

This property is retained as an older name for the certificate-result count associated with S/MIME encryption, decryption, and security-unwrapping operations.

Legacy byte-array method. Adds the PKCS #12/PFX data in pfxFileData to the internal collection of credential sources used by later S/MIME decryption operations. 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.

The source remains configured across subsequent LoadMime calls and repeated decryptions. Chilkat continues searching after a PFX that does not contain the required recipient key.

Returns 1 for success, 0 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 and the matching certificate is available through LastDecryptCert. On failure, the encrypted MIME remains unchanged.

Returns 1 for success, 0 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 1 for success, 0 for failure.

Deprecated. Use LastDecryptCert instead.

Loads the certificate at zero-based index from the certificate results recorded by the most recent applicable S/MIME 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 1 for success, 0 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 1 for success, 0 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 1 for success, 0 for failure.