The RemoteName property identifies a SQL Server Authentication login record on another server and controls mapping for that login.
object.RemoteName [= value]
| Part | Description |
|---|---|
| object | Expression that evaluates to an object in the Applies To list |
| value | String identifying a Microsoft® SQL Server™ login by name |
A SQL Server installation can maintain authentication information for connections originating from other SQL Server installations. 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.
String
Read/write
HRESULT GetRemoteName(SQLDMO_LPBSTR pRetVal);
HRESULT SetRemoteName(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.