• Article

LocalLogin Property

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

The LocalLogin property identifies a Microsoft SQL Server login mapped by a linked server login to authentication data used for connection to a linked server.

Syntax

object
.LocalLogin [=value]

Parts

  • object
    An expression that evaluates to an object in the Applies To list

  • value
    A string that identifies an existing SQL Server login

Data Type

String

Modifiable

Read/write if using the LinkedServerLogin object to create a new login mapping. Read-only if the LinkedServerLogin object references an existing login mapping.

Prototype (C/C++)

HRESULT GetLocalLogin(SQLDMO_LPBSTR pRetVal);
HRESULT SetLocalLogin(SQLDMO_LPCSTR NewValue);

Note

SQL Distributed Management Objects (SQL-DMO) strings are always returned as OLE BSTR objects. A C/C++ application obtains a reference to the string. The application must release the reference using SysFreeString.

Remarks

SQL Server implements persisted storage for an OLE DB data source definition, called a linked server. For each linked server, an optional mapping for a SQL Server login can determine authentication data used when a connection using that login attempts to connect to the linked server.