sys-fn-translate-permissions-transact-sql.md

title	sys.fn_translate_permissions (Transact-SQL) | Microsoft Docs
ms.custom
ms.date	03/15/2017
ms.prod	sql-non-specified
ms.reviewer
ms.suite
ms.technology	database-engine
ms.tgt_pltfrm
ms.topic	language-reference
f1_keywords	sys.fn_translate_permissions sys.fn_translate_permissions_TSQL fn_translate_permissions fn_translate_permissions_TSQL
dev_langs	TSQL
helpviewer_keywords	permissions bitmask [SQL Server] sys.fn_translate_permissions function fn_translate_permissions function
ms.assetid	ac97121f-2bd0-4f71-8e45-42c8584edbc5
caps.latest.revision	18
author	BYHAM
ms.author	rickbyh
manager	jhubbard

sys.fn_translate_permissions (Transact-SQL)

[!INCLUDEtsql-appliesto-ss2008-xxxx-xxxx-xxx_md]

Translates the permissions bitmask returned by SQL Trace into a table of permissions names.

Applies to: [!INCLUDEssNoVersion] ([!INCLUDEssKatmai] through current version).

Transact-SQL Syntax Conventions

Syntax

  
sys.fn_translate_permissions ( level , perms )  

Arguments

level
Is the kind of securable to which the permission is applied. level is nvarchar(60).

perms
Is a bitmask that is returned in the permissions column. perms is varbinary(16).

Returns

table

Remarks

The value returned in the permissions column of a SQL Trace is an integer representation of a bitmask used by [!INCLUDEssNoVersion] to calculate effective permissions. Each of the 25 kinds of securables has its own set of permissions with corresponding numerical values. sys.fn_translate_permissions translates this bitmask into a table of permissions names.

Permissions

Requires membership in the public role.

Example

The following query uses sys.fn_builtin_permissions to display the permissions that apply to certificates, and then uses sys.fn_translate_permissions to return the results of the permissions bitmask.

SELECT * FROM sys.fn_builtin_permissions('CERTIFICATE');  
SELECT '0001' AS Input, * FROM sys.fn_translate_permissions('CERTIFICATE', 0001);  
SELECT '0010' AS Input, * FROM sys.fn_translate_permissions('CERTIFICATE', 0010);  
SELECT '0011' AS Input, * FROM sys.fn_translate_permissions('CERTIFICATE', 0011);  

See Also

Permissions (Database Engine)
sys.server_permissions (Transact-SQL)
sys.database_permissions (Transact-SQL)