ASYMKEYPROPERTY (Transact-SQL)ASYMKEYPROPERTY (Transact-SQL)

S’applique à :Applies to: ouiSQL ServerSQL Server (toutes les versions prises en charge) yesSQL ServerSQL Server (all supported versions) OuiAzure SQL DatabaseAzure SQL DatabaseYesAzure SQL DatabaseAzure SQL DatabaseS’applique à :Applies to: ouiSQL ServerSQL Server (toutes les versions prises en charge) yesSQL ServerSQL Server (all supported versions) OuiAzure SQL DatabaseAzure SQL DatabaseYesAzure SQL DatabaseAzure SQL Database

Cette fonction retourne les propriétés d'une clé asymétrique.This function returns the properties of an asymmetric key.

Icône Lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

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

Notes

Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 et versions antérieures, consultez Versions antérieures de la documentation.To view Transact-SQL syntax for SQL Server 2014 and earlier, see Previous versions documentation.

ArgumentsArguments

Key_IDKey_ID
ID d'une clé asymétrique dans la base de données.The Key_ID of an asymmetric key in the database. Si vous connaissez uniquement le nom de la clé, utilisez ASYMKEY_ID pour rechercher son ID.If you only know the key name, use ASYMKEY_ID to find the Key_ID. Key_ID est de type int.Key_ID has data type int.

' algorithm_desc '' algorithm_desc '
Spécifie que la sortie retourne la description de l'algorithme de la clé asymétrique.Specifies that the output returns the algorithm description of the asymmetric key. Uniquement disponible pour les clés asymétriques créées à partir d'un module EKM.Only available for asymmetric keys created from an EKM module.

' string_sid '' string_sid '
Spécifie que la sortie retourne le SID de la clé asymétrique au format nvarchar().Specifies that the output returns the SID of the asymmetric key, in nvarchar() format.

' sid '' sid '
Spécifie que la sortie retourne le SID de la clé asymétrique au format binaire.Specifies that the output returns the SID of the asymmetric key in binary format.

Types de retourReturn types

sql_variantsql_variant

AutorisationsPermissions

Nécessite une ou des autorisations appropriées sur la clé asymétrique et que l'autorisation VIEW sur la clé asymétrique n’ait pas été refusée à l’appelant.Requires appropriate permission(s) on the asymmetric key, and requires that the caller has not been denied VIEW permission on the asymmetric key. Consultez CREATE ASYMMETRIC KEY (Transact-SQL) pour plus d’informations sur les autorisations sur une clé asymétrique.See CREATE ASYMMETRIC KEY (Transact-SQL) for more information about asymmetric key permissions.

ExemplesExamples

L'exemple suivant retourne les propriétés de la clé asymétrique dont l'ID de clé (Key_ID) a la valeur 256.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  

Voir aussiSee also

CREATE ASYMMETRIC KEY (Transact-SQL)CREATE ASYMMETRIC KEY (Transact-SQL)
ALTER ASYMMETRIC KEY (Transact-SQL)ALTER ASYMMETRIC KEY (Transact-SQL)
DROP ASYMMETRIC KEY (Transact-SQL)DROP ASYMMETRIC KEY (Transact-SQL)
SIGNBYASYMKEY (Transact-SQL)SIGNBYASYMKEY (Transact-SQL)
VERIFYSIGNEDBYASYMKEY (Transact-SQL)VERIFYSIGNEDBYASYMKEY (Transact-SQL)
Hiérarchie de chiffrementEncryption Hierarchy
sys.asymmetric_keys (Transact-SQL)sys.asymmetric_keys (Transact-SQL)
Affichages catalogue de sécurité (Transact-SQL)Security Catalog Views (Transact-SQL)
ASYMKEY_ID (Transact-SQL)ASYMKEY_ID (Transact-SQL)
SYMKEYPROPERTY (Transact-SQL)SYMKEYPROPERTY (Transact-SQL)