Share via


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.

Applies To:

RemoteLogin Object