Role Property (SQL-DMO)

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

Applies To

Syntax

object.Role [= value]

Part	Description
object	Expression that evaluates to an object in the Applies To list
value	String identifying an existing fixed or user-defined database role by name

Remarks

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

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 by using SysFreeString.