InitializeNT

[This is preliminary documentation and subject to change.]

This function is called during Windows NT GUI Mode Setup when the Windows NT phase of the upgrade is ready to start.

LONG
CALLBACK 
InitializeNT(
    IN LPCWSTR WorkingDirectory,
    IN LPCWSTR SourceDirectories,
    LPVOID Reserved
    );

Parameters

WorkingDirectory

Points to the path of the Setup-supplied working directory. This value is the value that your migration DLL used for storing its private temporary data and files during the Windows 95 or Windows 98 phase of the upgrade.

SourceDirectories

Points to the path of the Windows NT installation files. This path is a multi-sz because multiple source directories can be provided. Normally this directory is D:\I386 or C:\$WIN_NT$.~LS\I386 where D:\ is the CD-ROM drive on the computer and C:\$WIN_NT$.~LS\I386 is the Setup temporary source directory.

Reserved

Reserved for future use.

Return Values

ERROR_SUCCESS if your migration DLL initializes properly within the Windows NT environment.

All other return values (Win32 error values) are considered critical errors. Setup reports the error to the user and then cancels processing your migration DLL. However, Setup will not continue the upgrade. Any errors or logs generated will include the ProductID string specified in QueryVersion to identify your DLL.

Exceptions generated by your migration DLL cause Setup to report RPC error messages. Setup provides more information in SETUPERR.LOG.

Remarks

InitializeNT is called during Windows NT GUI Mode Setup when the Windows NT phase of application migration is ready to start. When this function is called, the current directory is set to the DLL working directory.

Your migration DLL must not display user messages in its InitializeNT function.