RemoteName Property

SQL-DMO

SQL-DMO

RemoteName Property

The RemoteName property identifies a SQL Server Authentication login record on another server and controls mapping for that login.

Applies To
RemoteLogin Object
Syntax

object.RemoteName [= value]

Parts

object

Expression that evaluates to an object in the Applies To list

value

String that identifies a Microsoft® SQL Server™ 2000 login by name

Data Type

String

Modifiable

Read/write

Prototype (C/C++)

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 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.