RemoteName 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 RemoteName property identifies a SQL Server Authentication login record on another server and controls mapping for that login.
Syntax
object
.RemoteName [= value]
Parts
- object
An expression that evaluates to an object in the Applies To list
- value
A string that identifies a Microsoft SQL Server login by name
Data Type
String
Modifiable
Read/write
Prototype (C/C++)
HRESULT GetRemoteName(SQLDMO_LPBSTR pRetVal);
HRESULT SetRemoteName(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 maintain authentication information for connections originating from other instances of SQL Server. Server-originated connections are attempted when, for example, remote procedure calls are part of a Transact-SQL script.
When a server-originated connection is attempted, and the client connection to the server originating the connection request uses the login referenced by the RemoteName property, that login is mapped to the SQL Server login represented by the LocalName property of the RemoteLogin object.