NetCode Configuration

The component accepts one or more of the following configuration settings. Configuration settings are similar in functionality to properties, but they are rarely used. In order to avoid "polluting" the property namespace of the component, access to these internal properties is provided through the Config method.

NetCode Configuration Settings


	Base64LineBreak: Tells the component whether to include line breaks in Base64 encoded content or not. By default, when encoding to Base64 format, the component will insert line breaks every 76 characters. Setting the Base64LineBreak config to false will cause these line breaks to be omitted from the Base64 encoded content. The default value is true.
	HMACAlgorithm: The hash algorithm to use when generating a Hash-based Message Authentication Code (HMAC). HMACAlgorithm is used to tell the component which hashing algorithm to use to generate the Hash-based Message Authentication Code (HMAC). HMACAlgorithm can be "SHA1" (Secure Hash Algorithm 1), "MD5" (Message Digest 5), or one of the SHA-2 algorithms mentioned below. You may truncate the hash output by specifying the desired number of bits. For instance "SHA1-96" and "MD5-96" are acceptable. The component is capable utilizing the set of HMAC SHA-2 algorithms ("SHA-224", "SHA-256", "SHA-384", and "SHA-512"). The component also supports "RIPEMD160" as an HMAC algorithm.
	HMACKey: A key to use when generating a Hash-based Message Authentication Code (HMAC). When using the Format fmtHMAC, it may be necessary to supply the component with a key to use when generating the Hash-based Message Authentication Code (HMAC). This key is incorporated into the hashing process to add entropy to the resulting hash code, making the plaintext harder to guess and increasing the message security. You may also set this to a hex value. For instance 0xAAAAAA is acceptable.
	MaxFileSize: When encoding, controls whether encoded data should be split into several files and gives the maximum allowed size for these files. Some mailing systems require that the message size shouldn't exceed a certain size. Assigning a nonzero value to MaxFileSize makes the component split the encoded data into several files. FileCnt will contain the number of files created. Please refer to EncodedFile for filename conventions. The default value for this setting is 0 (no limit). IMPORTANT: if a non-zero value is assigned to MaxFileSize then a multiple filename should also be assigned to EncodedFile (end with question marks "?") so that the component can expand the filenames. Please refer to the Error Messages section for a complete list of possible errors.
	UseModifiedUTF7: Specifies whether or not a modified form of UTF-7 for IMAP mailbox naming is used. When Format is set to fmtUTF7, UseModifiedUTF7 is used to tell the component whether or not to use a modified version of UTF-7 for IMAP mailbox naming. The default value is False.
	UseExtendedHexBase32: Specifies whether or not the Extended Hex alphabet is used. When Format is set to fmtBase32, UseExtendedHexBase32 is used to tell the component whether or not to use the Extended Hex alphabet. The default value is False.

Base Configuration Settings

GUIAvailable: Tells the component whether or not a message loop is available for processing events.

In a GUI-based application, long-running blocking operations may cause the application to stop responding to input until the operation returns. The component will attempt to discover whether or not the application has a message loop and, if one is discovered, it will process events in that message loop during any such blocking operation.

In some non-GUI applications an invalid message loop may be discovered that will result in errant behavior. In these cases, setting GuiAvailable to false will ensure that the component does not attempt to process external events.

UseBackgroundThread: Whether threads created by the component are background threads.

If set to True, when the component creates a thread the thread's IsBackground property will be explicitly set to True. By default this setting is False.