Export (0) Print
Expand All
Expand Minimize

ProfileName Property (Replication)

SQL Server 2000

ProfileName Property (Replication)

The ProfileName property specifies the name of the agent profile at the Distributor to be used by the Replication object. A profile defines behavior such as time-out values. You can override the default values by creating a profile on the Distributor and specifying its name through ProfileName.

Applies To

SQL Server CE Replication object

Syntax
object.ProfileName [= value]
Part Description
object SQL Server CE Replication object
value Agent profile name
Data Type

string

Modifiable

Read/write

Prototype eVC++
HRESULT get_ProfileName(BSTR *pVal);
HRESULT put_ProfileName(BSTR newVal);
Remarks

A profile contains a set of parameters that control the behavior of the SQL Server Reconciler. For example, the profile specifies the LoginTimeOut and QueryTimeOut values used by the SQL Server Reconciler. The profile is stored on the Distributor. The profile is read each time a subscription is synchronized. For more information, see "Agent Profiles" in SQL Server Books Online.

The profile allows you to easily change key parameters for synchronization. For example, if you have five Microsoft® SQL Server™ 2000 Windows® CE Edition (SQL Server CE) clients that share a profile and you want to change the query time-out value, you simply change the QueryTimeOut value in the profile, and then all SQL Server CE clients will use the new QueryTimeOut value.

You can also create different profiles for different SQL Server CE clients. For example, a SQL Server CE client that uses a dial-up Internet connection might use one time-out value, and a client that uses a high-speed intranet connection might use a different time-out value. ProfileName is used to specify the name of the profile.

If ProfileName is not specified, the default profile values are used.

If ProfileName is specified, the LoginTimeOut and QueryTimeOut parameters specified in the profile will override the LoginTimeOut and QueryTimeOut property values specified through the Replication object.

See Also
LoginTimeout Property (Replication)

QueryTimeout Property (Replication)

Replication Object Properties

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft