Role Property

SQL-DMO

SQL-DMO

Role Property

The Role property identifies the initial security role assigned to the Microsoft® SQL Server™ 2000 database user.

Applies To
User Object
Syntax

object.Role [= value]

Parts

object

Expression that evaluates to an object in the Applies To list

value

String that identifies an existing fixed or user-defined database role by name

Data Type

String

Modifiable

Read/write when using the User object to create a database user.

Prototype (C/C++)

HRESULT GetRole(SQLDMO_LPBSTR pRetVal);

HRESULT SetRole(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

If not specified, a user created by using the User object will be given membership in the fixed database security role public.