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 NT 4.0, Microsoft Windows 2000, or Microsoft Windows Server 2003 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 NT 4.0, Microsoft Windows 2000, or Microsoft Windows Server 2003 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, Microsoft Windows 2000, or Microsoft Windows Server 2003 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\someone")
When specifying a Windows NT 4.0, Microsoft Windows 2000, or Microsoft Windows Server 2003 group using the Account argument, the QueryResults object returned contains one row for each Windows NT 4.0, Microsoft Windows 2000, or Microsoft Windows Server 2003 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.