CollationName Property

SQL-DMO

SQL-DMO

CollationName Property

The CollationName property retrieves or sets the collation name of a linked server.

Applies To
LinkedServer2 Object
Syntax

object.CollationName [= value]

Part

object

Expression that evaluates to an object in the Applies To list

value

String that specifies a valid collation name

Data Type

String

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetCollationName(SQLDMO_LPBSTR pRetVal);

HRESULT SetCollationName(SQLDMO_LPCSTR NewValue);

Remarks

If CollationName is not set, the default collation is used. When set to the default collation, CollationName returns NULL. Prior to setting the CollationName property, use the ListCollations method to retrieve a list of valid collation names. Setting CollationName to NULL or an empty string results in setting the collation back to the default.

Note  If an application calls CollationName on an instance of Microsoft® SQL Server™ version 7.0, the constant, SQLDMO_E_SQL80ONLY, and the message "This property or method requires Microsoft SQL Server 2000" are returned.