CERTPROPERTY (Transact-SQL)

Article
08/20/2013

Retourne la valeur d'une propriété de certificat spécifiée.

Icône Lien de rubrique Conventions de la syntaxe Transact-SQL

Syntaxe

CertProperty ( Cert_ID , '<PropertyName>' )

<PropertyName> ::=
   Expiry_Date | Start_Date | Issuer_Name 
   | Cert_Serial_Number | Subject | SID | String_SID

Arguments

Cert_ID
ID du certificat. Cert_ID est de type int.
Expiry_Date
Date d'expiration du certificat.
Start_Date
Date à laquelle le certificat devient valide.
Issuer_Name
Nom de l'émetteur du certificat.
Cert_Serial_Number
Numéro de série du certificat.
Subject
Objet du certificat.
SID
SID du certificat. C'est également le SID de n'importe quelle connexion ou utilisateur mappés à ce certificat.
String_SID
SID du certificat, sous forme de chaîne de caractères. C'est également le SID de n'importe quelle connexion ou utilisateur mappés à ce certificat.

Type des valeurs renvoyées

La spécification de la propriété doit être placée dans des guillemets simples (').

Le type de valeur retournée dépend de la propriété qui est spécifiée dans l'appel de la fonction. Toutes les valeurs retournées sont contenues dans le type de valeur retournée de sql_variant.

Expiry_Date et Start_Date retournent datetime.
Cert_Serial_Number, Issuer_Name, Subject et String_SID retournent nvarchar.
SID retourne varbinary.

Notes

Des informations sur les certificats sont visibles dans l'affichage catalogue sys.certificates.

Autorisations

Il faut des autorisations sur le certificat et l'appelant ne doit pas avoir refusé l'autorisation VIEW DEFINITION sur le certificat.

Exemple

L'exemple suivant retourne l'objet du certificat.

-- First create a certificate.
CREATE CERTIFICATE Marketing19 WITH 
    START_DATE = '04/04/2004' ,
    EXPIRY_DATE = '07/07/2007' ,
    SUBJECT = 'Marketing Print Division';
GO

-- Now use CertProperty to examine certificate
-- Marketing19's properties.
DECLARE @CertSubject sql_variant;
set @CertSubject = CertProperty( Cert_ID('Marketing19'), 'Subject');
PRINT CONVERT(nvarchar, @CertSubject);
GO