MigrationLogObj Object [C++]
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:
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
[Visual Basic]MigrationMainObj Object
[Visual Basic]MigrationModify Object
[Visual Basic]MigrationReadObj Object
[Visual Basic]MigrationWriteObj Object
Copyright © 2005 Microsoft Corporation.
All rights reserved.