LinkedServerLogin Object

LinkedServerLogin Object

The LinkedServerLogin object exposes the properties of an authentication record mapping used when an instance of Microsoft® SQL Server™ 2000 attempts to connect to a linked server.

Properties

LocalLogin Property	RemotePassword Property
Impersonate Property	RemoteUser Property

Methods

Remarks

SQL Server supports Transact-SQL queries against data stored in one or more SQL Server and heterogeneous databases. SQL Server distributed queries use OLE DB to access a nonlocal data store.

OLE DB defines a provider as an OLE DB component that can deliver data from a store. Typically, OLE DB providers can discriminate among applicable, available data stores. OLE DB defines a data source as that information necessary for the successful delivery of data from the store (such as a user identifier and password).

SQL Server implements persistent storage of an OLE DB provider name and data source definition called a linked server. A record maintaining authentication data for a linked server is called a linked server login.

With the LinkedServerLogin object, you can:

• Map SQL Server authentication data to authentication data required by a linked server.
  
  
• Configure existing authentication mappings.
  
  
• Remove an existing authentication mapping, disabling linked server accessibility for the SQL Server login record mapped.

To create a linked server login

1. Create a LinkedServerLogin object.
   
   
2. Set the LocalLogin property.
   
   
3. If authentication impersonation is supported and desired, set the Impersonate property. Otherwise, set the RemoteUser and RemotePassword properties to authentication data values valid for the linked server.
   
   
4. Add the LinkedServerLogin object to the LinkedServerLogins collection of a LinkedServer object referencing the appropriate linked server.

   Note  When a linked server is created, SQL Server creates a default linked server login specifying a NULL local login name and authentication impersonation. This special purpose login mapping record provides authentication data mapping for those logins not mapped explicitly.