asymkeyproperty-transact-sql.md

title	ASYMKEYPROPERTY (Transact-SQL) | Microsoft Docs
ms.custom
ms.date	07/24/2017
ms.prod	sql-non-specified
ms.reviewer
ms.suite
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	BYHAM
ms.author	rickbyh
manager	jhubbard

ASYMKEYPROPERTY (Transact-SQL)

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

Returns the properties of an asymmetric key.

Transact-SQL Syntax Conventions

Syntax

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

Arguments

Key_ID
Is the Key_ID of an asymmetric key in the database. To find the Key_ID when you only know the key name, use ASYMKEY_ID. Key_ID is 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 some permission on the asymmetric key and that the caller has not been denied VIEW permission on the asymmetric key.

Examples

The following example returns the properties of the asymmetric key with 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)