Login Property (SQL-DMO)

The Login property exposes the name of a Microsoft® SQL Server™ login record.

Applies To
RegisteredServer Object User Object
SQLServer Object  

Syntax

object.Login [= value]

Part Description
object Expression that evaluates to an object in the Applies To list
value Valid SQL Server login record name string

Remarks

For the RegisteredServer object, the Login property identifies the login used by default when a connection is made to the SQL Server installation by a Microsoft client utility.

For the User object, the property associates the referenced database user with a specific SQL Server login record.

For the SQLServer object, the Login property provides a username for connecting when SQL Server Authentication is used to connect the object to a server running SQL Server.

Data Type

String

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetLogin(SQLDMO_LPBSTR pRetVal);

HRESULT SetLogin(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.


  


(c) 1988-98 Microsoft Corporation. All Rights Reserved.