Share via

MigrationLogObj Object [C++]

  • Article

Use this object to write log data to the data store determined by the connection string. The data includes the status of each migration.

ProgID:   MigrationLog (Externally creatable)
COM Class Name:   MigrationLog
Type Library Name:   MigrationLogObj 1.0 Type Library

[C++]

COM Interface Name:   IMigrationLog
Interface ID Constant:   None
Header File:   MigrationLog.h

Methods

[C++]

Method Description
Initialize Initializes the MigrationLogObj object.
LogSuccess Writes the success code to the log file.
RecordInfo Records data to the log file.

[Visual Basic]

Method Description
Initialize Initializes the MigrationLogObj object.
LogSuccess Writes the success code to the log file.
RecordInfo Records data to the log file.

[C++]

The IMigrationLogObj interface depends on the following structure:

typedef struct _LOGINFO
{
    long  lProfile_id
    BSTR  bstrDN;
    BSTR  bstrObject;
    Long  lErrorCode;
    BSTR  bstrReason;
} LOGINFO;

Requirements

The following table contains the requirements of the MigrationLogObj object.

Parameter Description
Registry key SYSTEM\\CurrentControlSet\\Services\\Migration\\Parameters
LogFilePath The path of the log file. The default is "C:\MigrationLogObj". The data type is String.
MaxNumLinesEachFile The maximum number of lines in each log file. If the number of lines exceeds this number, another log file is created in the same directory. The data type is DWORD.
MaxNumThreads The maximum number of threads that run against the migration tool. The default value is four (4). The data type is DWORD.
AttributeFactors The number of entries in the mapping section for each attribute in an XML file. The type is DWORD. The default value is four (4), counting the following four lines: 
<FromMembership>givenName</FromMembership>
<ToUPS>GeneralInfo.first_name</ToUPS>
<WProfileType>UserObject</WProfileType>
<WTypes>VT_BSTR</WTypes>

Each attribute in the mapping section contains these four lines, with different values.
ADsSearchPageSize Size of search page. The type is DWORD. See the Active Directory Service Interfaces (ADSI) documentation for more information.
MaxNumLinesEachFile The maximum number of lines in each log file. When this number is reached, a new log file is created in the same location with the file name extended with sequential numbers. The data type is DWORD.
NumberOfLinesToFlush Use this parameter to flush the memory when the log file contains the indicated number of lines. The data type is DWORD.
MaxAttributesFetched The number of attributes having values you request from the Membership Directory. A number that is too high may result in a timeout; a number that is too low will adversely affect performance. Do not set this value first.

Set this value to 50 if you receive a timeout error in the MigrationReadObj object. The data type is DWORD.
InitialWaitPeriod The time in milliseconds that the process sleeps for the first time. The default value is zero (0). It is recommended you set this to less than five (5). The data type is DWORD.
BackOffTimes The number of times to retry in case of failure. The default value is zero (0). It is recommended you set this to less than four (4). The data type is DWORD.
LogLevel Log level values are:

0 = Logs error only

1 = Logs error and success

2 = Logs error and performance

3 = Logs error and success and performance

The data type is DWORD.

The IMigrationLogObj interface depends on the following structure:

typedef struct _LOGINFO
{
    long  lProfile_id
    BSTR  bstrDN;
    BSTR  bstrObject;
    Long  lErrorCode;
    BSTR  bstrReason;
} LOGINFO;

See Also

[C++]MigrationMainObj Object

[C++]MigrationModify Object

[C++]MigrationReadObj Object

[C++]MigrationWriteObj Object

[Visual Basic]MigrationMainObj Object

[Visual Basic]MigrationModify Object

[Visual Basic]MigrationReadObj Object

[Visual Basic]MigrationWriteObj Object

Copyright © 2005 Microsoft Corporation.
All rights reserved.