EnumAccountInfo Method

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

The EnumAccountInfo method returns a QueryResults object that enumerates Microsoft Windows accounts granted access permission to an instance of Microsoft SQL Server.

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 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 group granting access

Remarks

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

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

When specifying a Windows group using the Account argument, the QueryResults object returned contains one row for each Windows 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 groups in which the specified user has membership.

Applies To: