Partilhar via


xp_enumgroups (Transact-SQL)

Aplica-se a:SQL Server

Fornece uma lista de grupos locais do Microsoft Windows ou uma lista de grupos globais definidos em um domínio especificado do Windows.

Transact-SQL convenções de sintaxe

Sintaxe

xp_enumgroups [ 'domain_name' ]

Argumentos

Importante

Os argumentos para procedimentos armazenados estendidos devem ser inseridos na ordem específica, conforme descrito na seção de sintaxe. Se os parâmetros forem inseridos fora de ordem, ocorrerá uma mensagem de erro.

'domain_name'

O nome do domínio do Windows para o qual enumerar uma lista de grupos globais. domain_name é sysname, com um padrão de NULL.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Conjunto de resultados

Nome da coluna Tipo de dados Descrição
grupo sysname Nome do grupo Windows
comentário sysname Descrição do grupo Windows fornecido pelo Windows

Comentários

Se domain_name for o nome do computador baseado no Windows em que uma instância do SQL Server está sendo executada ou nenhum nome de domínio for especificado, xp_enumgroups enumerará os grupos locais do computador que está executando o SQL Server.

Permissões

Requer associação à função de banco de dados fixa db_owner no banco de dados master ou associação à função de servidor sysadmin fixa.

Exemplos

O exemplo a seguir lista os grupos no domínio sales.

EXECUTE xp_enumgroups 'sales';