xp_logininfo (T-SQL)
Berlaku untuk: 
SQL Server
Mengembalikan informasi tentang pengguna Windows dan grup Windows.
Sintaks
xp_logininfo [ [ @acctname = ] 'account_name' ]
[ , [ @option = ] 'all' | 'members' ]
[ , [ @privilege = ] 'variable_name' OUTPUT ]
Argumen
[ @acctname = ] '@acctname'
Nama pengguna atau grup Windows yang diberikan akses ke SQL Server. @acctname adalah sysname, dengan default NULL. Jika @acctname tidak ditentukan, semua grup Windows dan pengguna Windows yang telah diberi izin masuk secara eksplisit akan dilaporkan. @acctname harus sepenuhnya memenuhi syarat. Misalnya, CONTOSO\macraes atau BUILTIN\Administrators.
[ @option = ] 'semua' | 'anggota' ]
Menentukan apakah akan melaporkan informasi tentang semua jalur izin untuk akun tersebut, atau melaporkan informasi tentang anggota grup Windows. @option adalah varchar(10), dengan default NULL. Kecuali all ditentukan, hanya jalur izin pertama yang ditampilkan.
[ @privilege = ] OUTPUT 'variable_name' ]
Parameter output yang mengembalikan tingkat hak istimewa dari akun Windows yang ditentukan. @privilege adalah varchar(10), dengan default Not wanted. Tingkat hak istimewa yang dikembalikan adalah pengguna, admin, atau null.
Ketika OUTPUT ditentukan, opsi ini menempatkan @privilege dalam parameter output.
Mengembalikan nilai kode
0 (berhasil) atau 1 (kegagalan).
Tataan hasil
| Nama kolom | Jenis data | Deskripsi |
|---|---|---|
| nama akun | nama sysname | Nama akun Windows yang sepenuhnya memenuhi syarat. |
| jenis | karakter(8) | Jenis akun Windows. Nilai yang valid adalah user atau group. |
| Hak istimewa | karakter(9) | Hak istimewa akses untuk SQL Server. Nilai yang valid adalah admin, user, atau NULL. |
| nama masuk yang dipetakan | nama sysname | Untuk akun pengguna yang memiliki hak istimewa pengguna, nama masuk yang dipetakan menunjukkan nama masuk yang dipetakan yang coba digunakan SQL Server saat masuk dengan akun ini dengan menggunakan aturan yang dipetakan dengan nama domain yang ditambahkan sebelum akun tersebut. |
| jalur izin | nama sysname | Keanggotaan grup yang mengizinkan akses akun. |
Keterangan
Jika @acctname ditentukan, xp_logininfo laporkan tingkat hak istimewa tertinggi pengguna atau grup Windows yang ditentukan. Jika pengguna Windows memiliki akses sebagai administrator sistem dan sebagai pengguna domain, pengguna tersebut dilaporkan sebagai administrator sistem. Jika pengguna adalah anggota dari beberapa grup Windows dengan tingkat hak istimewa yang sama, hanya grup yang pertama kali diberikan akses ke SQL Server yang dilaporkan.
Jika @acctname adalah pengguna atau grup Windows yang valid yang tidak terkait dengan login SQL Server, kumpulan hasil kosong dikembalikan. Jika @acctname tidak dapat diidentifikasi sebagai pengguna atau grup Windows yang valid, pesan kesalahan akan dikembalikan.
Jika @acctname dan all ditentukan, semua jalur izin untuk pengguna atau grup Windows dikembalikan. Jika @acctname adalah anggota dari beberapa grup, yang semuanya telah diberikan akses ke SQL Server, beberapa baris dikembalikan. Baris admin hak istimewa dikembalikan sebelum user baris hak istimewa, dan dalam tingkat hak istimewa, baris dikembalikan dalam urutan pembuatan login SQL Server yang sesuai.
Jika @acctname dan members ditentukan, daftar anggota grup tingkat berikutnya dikembalikan. Jika @acctname adalah grup lokal, daftar dapat menyertakan pengguna lokal, pengguna domain, dan grup. Jika @acctname adalah akun domain, daftar tersebut terdiri dari pengguna domain. SQL Server harus tersambung ke pengendali domain untuk mengambil informasi keanggotaan grup. Jika server tidak dapat menghubungi pengendali domain, tidak ada informasi yang dikembalikan.
xp_logininfo hanya mengembalikan informasi dari grup global Direktori Aktif, bukan grup universal.
Izin
Memerlukan keanggotaan dalam peran server tetap sysadmin atau keanggotaan dalam peran database tetap publik dalam master database dengan izin EXECUTE yang diberikan.
Contoh
Contoh berikut menampilkan informasi tentang BUILTIN\Administrators grup Windows.
EXEC xp_logininfo 'BUILTIN\Administrators';