Condividi tramite

  • Articolo

CertProperty (Transact-SQL)

Restituisce il valore di una proprietà del certificato specificata.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

CertProperty ( Cert_ID , '<PropertyName>' )

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

Argomenti

  • Cert_ID
    ID del certificato. Cert_ID è di tipo int.

  • Expiry_Date
    Data di scadenza del certificato.

  • Start_Date
    Data in cui il certificato è diventato valido.

  • Issuer_Name
    Nome dell'autorità che ha emesso il certificato.

  • Cert_Serial_Number
    Numero di serie del certificato.

  • Subject
    Oggetto del certificato.

  • SID
    SID del certificato. Corrisponde anche al SID di qualsiasi account di accesso o utente mappato al certificato.

  • String_SID
    SID del certificato nel formato di stringa di caratteri. Corrisponde anche al SID di qualsiasi account di accesso o utente mappato al certificato.

Tipi restituiti

La specifica della proprietà deve essere racchiusa tra virgolette singole.

Il tipo restituito dipende dalla proprietà specificata nella chiamata alla funzione. Tutti i valori restituiti vengono inclusi nel tipo restituito di sql_variant.

  • Expiry_Date e Start_Date restituiscono il tipo datetime.

  • Cert_Serial_Number, Issuer_Name, Subject, e String_SID restituiscono il tipo nvarchar.

  • SID restituisce il tipo varbinary.

Osservazioni

Le informazioni sui certificati sono visibili nella vista del catalogo sys.certificates.

Autorizzazioni

Sono richieste autorizzazioni per il certificato ed è necessario che al chiamante non sia stata negata l'autorizzazione VIEW DEFINITION per il certificato.

Esempi

Nell'esempio seguente viene restituito l'oggetto del certificato.

-- 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