asymkeyproperty-transact-sql.md

title	ASYMKEYPROPERTY (Transact-SQL) | Microsoft Docs
ms.custom
ms.date	07/24/2017
ms.prod	sql
ms.prod_service	database-engine, sql-database
ms.service
ms.component	t-sql|functions
ms.reviewer
ms.suite	sql
ms.technology	database-engine
ms.tgt_pltfrm
ms.topic	language-reference
f1_keywords	ASYMKEYPROPERTY_TSQL ASYMKEYPROPERTY
dev_langs	TSQL
helpviewer_keywords	ASYMKEYPROPERTY
ms.assetid	a30581f2-e1b1-4996-93e6-527ff96b7c42
caps.latest.revision	13
author	edmacauley
ms.author	edmaca
manager	craigg
ms.workload	Inactive

ASYMKEYPROPERTY (Transact-SQL)

[!INCLUDEtsql-appliesto-ss2008-asdb-xxxx-xxx-md]

This function returns the properties of an asymmetric key.

Transact-SQL Syntax Conventions

Syntax

ASYMKEYPROPERTY (Key_ID , 'algorithm_desc' | 'string_sid' | 'sid')  

Arguments

Key_ID
The Key_ID of an asymmetric key in the database. If you only know the key name, use ASYMKEY_ID to find the Key_ID. Key_ID has data type int.

'algorithm_desc'
Specifies that the output returns the algorithm description of the asymmetric key. Only available for asymmetric keys created from an EKM module.

'string_sid'
Specifies that the output returns the SID of the asymmetric key, in nvarchar() format.

'sid'
Specifies that the output returns the SID of the asymmetric key in binary format.

Return types

sql_variant

Permissions

Requires appropriate permission(s) on the asymmetric key, and requires that the caller has not been denied VIEW permission on the asymmetric key. See CREATE ASYMMETRIC KEY (Transact-SQL) for more information about asymmetric key permissions.

Examples

The following example returns the properties of the asymmetric key of Key_ID 256.

SELECT   
ASYMKEYPROPERTY(256, 'algorithm_desc') AS Algorithm,  
ASYMKEYPROPERTY(256, 'string_sid') AS String_SID,  
ASYMKEYPROPERTY(256, 'sid') AS SID ;  
GO  

See also

CREATE ASYMMETRIC KEY (Transact-SQL)
ALTER ASYMMETRIC KEY (Transact-SQL)
DROP ASYMMETRIC KEY (Transact-SQL)
SIGNBYASYMKEY (Transact-SQL)
VERIFYSIGNEDBYASYMKEY (Transact-SQL)
Encryption Hierarchy
sys.asymmetric_keys (Transact-SQL)
Security Catalog Views (Transact-SQL)
ASYMKEY_ID (Transact-SQL)
SYMKEYPROPERTY (Transact-SQL)