CertProperty (Transact-SQL)
Restituisce il valore di una proprietà del certificato specificata.
.gif "Icona di collegamento a un argomento")
Convenzioni 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
Vedere anche
Riferimento
CREATE CERTIFICATE (Transact-SQL)
ALTER CERTIFICATE (Transact-SQL)
Cert_ID (Transact-SQL)
sys.certificates (Transact-SQL)
Viste del catalogo relative alla protezione (Transact-SQL)