IS_MEMBER (Transact-SQL)
Zeigt an, ob der aktuelle Benutzer ein Mitglied der angegebenen Microsoft Windows-Gruppe oder Microsoft SQL Server-Datenbankrolle ist.
.gif "Themenlink (Symbol)")
Transact-SQL-Syntaxkonventionen
Syntax
IS_MEMBER ( { 'group' | 'role' } )
Argumente
- 'group'
Der Name der Windows-Gruppe, die überprüft wird. Dieser muss das Format Domäne\Gruppe aufweisen. group ist ein Wert vom Datentyp sysname.
- 'role'
Der Name der SQL Server-Rolle, die überprüft wird. role ist ein Wert vom Datentyp sysname. Er kann feste Datenbankrollen oder benutzerdefinierte Rollen, nicht jedoch Serverrollen einschließen.
Rückgabetypen
int
Hinweise
IS_MEMBER gibt folgende Werte zurück.
| Rückgabewert | Beschreibung |
|---|---|
0 |
Der aktuelle Benutzer ist kein Mitglied von group oder role. |
1 |
Der aktuelle Benutzer ist Mitglied von group oder role. |
NULL |
Entweder ist group oder role ungültig. |
IS_MEMBER bestimmt die Windows-Gruppenmitgliedschaft durch Analysieren eines Zugriffstokens, das von Windows erstellt wird. Das Zugriffstoken spiegelt keine Änderungen an der Gruppenmitgliedschaft wider, die vorgenommen werden, nachdem ein Benutzer eine Verbindung mit einer Instanz von SQL Server hergestellt hat.
Beispiele
Im folgenden Beispiel wird überprüft, ob der aktuelle Benutzer ein Mitglied einer Datenbankrolle oder einer Windows-Domänengruppe ist.
-- Test membership in db_owner and print appropriate message.
IF IS_MEMBER ('db_owner') = 1
print 'Current user is a member of the db_owner role'
ELSE IF IS_MEMBER ('db_owner') = 0
print 'Current user is NOT a member of the db_owner role'
ELSE IF IS_MEMBER ('db_owner') IS NULL
print 'ERROR: Invalid group / role specified'
go
-- Execute SELECT if user is a member of ADVWORKS\Shipping.
IF IS_MEMBER ('ADVWORKS\Shipping') = 1
SELECT 'User ' + USER + ' is a member of ADVWORKS\Shipping.'
go
Siehe auch
Verweis
IS_SRVROLEMEMBER (Transact-SQL)
Sicherheitskatalogsichten (Transact-SQL)
sp_addrolemember (Transact-SQL)
sp_addsrvrolemember (Transact-SQL)
sp_droprolemember (Transact-SQL)
sp_dropsrvrolemember (Transact-SQL)