CertProperty (Transact-SQL)

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

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

CertProperty ( Cert_ID , '<PropertyName>' )

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

Arguments

  • Cert_ID
    Identificateur du certificat. Cert_ID est un entier.

  • 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