TixRegistrationInfo data type

The TixRegistrationInfo data type represents customer registration information and is passed in through the pExtra parameter of TixHandler for the following messages:

TIXMSG_APPLY_REGISTRATION
TIXMSG_CHECK_REGISTRATION
TIXMSG_INIT_REGISTRATION

Note: There is no guarantee that your extension DLL will receive all registration-related messages. In particular, the final TIXMSG_APPLY_REGISTRATION message is not sent if the installation process is prematurely terminated. Therefore, you should not use the lCookie field (below) for information that must be cleaned up (like allocated memory or an open file handle). Such information should be stored in the extension DLL's global state (accessible through pMessage->lCookie).

#define TIX_REGINFO_MAXSIZE 64

typedef struct TixRegistrationInfo
{
    TCHAR szField1[TIX_REGINFO_MAXSIZE];
    TCHAR szField2[TIX_REGINFO_MAXSIZE];
    TCHAR szField3[TIX_REGINFO_MAXSIZE];
    LPARAM lCookie;
} TixRegistrationInfo;

Data fields

szField1
szField2
szField3

Text displayed and retrieved as fields 1..3. The interpretation of each field is up to the extension DLL. If so configured, the installer will initialize these fields from existing information in the target system's registry. See TIXMSG_INIT_REGISTRATION for details.

lCookie

Client-defined additional value; may be used to store a status code or other registration-related information. The installer sets this field to 0 before the first use, then maintains its value between the various registration-related messages. However, you should not use this field to store information that must be cleaned up, because not all registration-related message are always sent and there may not be an opportunity to clean up.