AddPartitionDbServer Method

This method adds a SQL server database to the LDAP server's internal partition map for the specified container.

IDL Definition

HRESULT AddPartitionDbServer(
 [in] VARIANT lInstanceId,
 [in] VARIANT szContainerPartition,
 [in] VARIANT lSubPartitionNumber,      
 [out] VARIANT * dwServerId,            
 [in] VARIANT szServerName,      
 [in] VARIANT szDatabaseName,         
 [in] VARIANT szLogin,                  
 [in] VARIANT szPassword,            
 [in] VARIANT dwMaxCnx,               
 [in] VARIANT dwTimeout,               
 [in] VARIANT dwReplicationType,                                   
 [in] VARIANT lSubrefPartitionID,  
 [in] VARIANT lSubrefObjectID
);

Parameters

lInstanceId (VT_I4)

The LDAP virtual server instance

szContainerPartition (VT_BSTR)

The name of the namespace partition for which the addition is targeted

lSubPartitionNumber (VT_I4)

The number of the sub-partition for which the addition is targeted

dwServerId (VT_I4)

The server/database combination identifier for which the addition is targeted; this value is generated by the database and is returned here

szServerName (VT_BSTR)

The server hosting the SQL server

szDatabaseName (VT_BSTR)

The targeted database on the supporting SQL server

szLogin (VT_BSTR)

The login name for the supporting SQL server

szPassword (VT_BSTR)

The login password for each the supporting SQL server

dwMaxCnx (VT_I4)

The maximum number of concurrent connections allowed from the LDAP server to the SQL server

dwTimeout (VT_I4)

The maximum time a request will be allowed to remain outstanding on the SQL server (how long before the LDAP server gives up on getting a response back from the SQL server)

dwReplicationType (VT_I4)

The replication type of the supporting SQL server - A SQL server can be of types U2_REPLTYPE_WRITE, U2_REPLTYPE_READ, or U2_REPLTYPE_BOTH

lSubrefPartitionID (VT_I4)

If this is a sub-ref partition, this identifies which partition the sub-ref that references the new database lives on.  If this is not a partition this value MUST be bit-wise NOT ZERO (~0, or 0xffffffff)

lSubrefObjectID (VT_I4)

If this is a sub-ref partition, this tells us the DSID of the object which references the new database. If this is not a partition this value MUST be bit-wise NOT ZERO (~0, or 0xffffffff)

Return Values

a standard HRESULT value


© 1997-1998 Microsoft Corporation. All rights reserved.