EnumAccountInfo Method

SQL-DMO

SQL-DMO

EnumAccountInfo Method

The EnumAccountInfo method returns a QueryResults object that enumerates Microsoft® Windows NT® 4.0 or Microsoft Windows 2000 accounts granted access permission to an instance of Microsoft SQL Server™ 2000.

Applies To
SQLServer Object
Syntax

object.EnumAccountInfo( [ Account ] , [ ListAll ] ) as QueryResults

Parts

object

Expression that evaluates to an object in the Applies To list

Account

String that identifies an existing Windows user or group by name

ListAll

TRUE or FALSE

Prototype (C/C++)

HRESULT EnumAccountInfo(
LPSQLDMOQUERYRESULTS* ppResults,
SQLDMO_LPCSTR Account = NULL,
BOOL ListAll = FALSE);

Returns

A QueryResults object that contains one result set defined by these columns.

Column Data type Description
account name nvarchar(129) Windows NT 4.0 or Microsoft Windows 2000 account name
type varchar(18) String that identifies account type, such as group
privilege varchar(18) String that specifies privilege level, such as admin or username
mapped login name nvarchar(129) SQL Server login name used when mapping the account
permission path nvarchar(129) String that specifies Windows NT 4.0 or Microsoft Windows 2000 group granting access

Remarks

When using the Account argument to restrict results, fully qualify the Windows NT 4.0 or Microsoft Windows 2000 account name, that specifies both domain and user or group name. For example:

oQR = oSQLServer.EnumAccountInfo("SEATTLE\anned")

When specifying a Windows NT 4.0 or Microsoft Windows 2000 group using the Account argument, the QueryResults object returned contains one row for each Windows NT 4.0 or Microsoft Windows 2000 account with membership in the group.

Use the ListAll argument when that enumerates account information for Windows NT users. When ListAll is TRUE, the EnumAccountInfo method returns a result set that contains all SQL Server security-enabled Windows NT 4.0 or Microsoft Windows 2000 groups in which the specified user has membership.