Share via


LocalName 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 LocalName property identifies a Microsoft SQL Server login record used by a second server to determine permission level.

Syntax

object
.LocalName [=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

Prototype (C/C++)

HRESULT GetLocalName(SQLDMO_LPBSTR pRetVal);
HRESULT SetLocalName(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

An instance of SQL Server can implement SQL Server connection authorization for another instance of SQL Server. An authorized server can connect to execute a remote procedure call or for other purposes.

To establish authorization, a remote server is defined on the authorizing instance of SQL Server. A mapping (remote login) for a login established and maintained on the remote server can be built on the authorizing instance of SQL Server.

For example, a server, called AcctPay, used by an organization's accounts payable department, can execute remote stored procedures on the purchasing department's Purch server. On Purch, an AcctPayRemote login is created and given appropriate rights for all accounts payable department users. For each authorized login on AcctPay, a remote login is created and mapped to AcctPayRemote.

Note

Remote server and login records enable SQL Server Authentication for connections initiated by an instance of SQL Server.

Applies To:

RemoteLogin Object