LocalLogin Property (SQL-DMO)

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.

Applies To

LinkedServerLogin Object

Syntax

object.LocalLogin [= value]

Part Description
object Expression that evaluates to an object in the Applies To list
value String identifying an existing SQL Server login

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 a connection to the linked server.

Data Type

String

Modifiable

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

Prototype (C/C++)

HRESULT GetLocalLogin(SQLDMO_LPBSTR pRetVal);

HRESULT SetLocalLogin(SQLDMO_LPCSTR NewValue);


Note 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 by using SysFreeString.


  


(c) 1988-98 Microsoft Corporation. All Rights Reserved.