CERTPROPERTY (Transact-SQL)

van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceSQL-database in Microsoft Fabric

Retourneert de waarde van een opgegeven certificaateigenschap.

Transact-SQL syntaxis-conventies

Syntax

CertProperty ( Cert_ID , '<PropertyName>' )  
  
<PropertyName> ::=  
   Expiry_Date | Start_Date | Issuer_Name   
   | Cert_Serial_Number | Subject | SID | String_SID   

Arguments

Cert_ID
De certificaat-id-waarde van het gegevenstype int.

Expiry_Date
De vervaldatum van het certificaat.

Start_Date
De datum waarop het certificaat geldig wordt.

Issuer_Name
De naam van de certificaatverlener.

Cert_Serial_Number
Het serienummer van het certificaat.

Subject
Het certificaatonderwerp.

SID
De certificaat-SID. Dit is ook de SID van elke aanmelding of gebruiker die is toegewezen aan dit certificaat.

String_SID
De SID van het certificaat als tekenreeks. Dit is ook de SID van elke aanmelding of gebruiker die is toegewezen aan het certificaat.

Retourtypen

Enkele aanhalingstekens moeten de eigenschapsspecificatie insluiten.

Het retourtype is afhankelijk van de eigenschap die is opgegeven in de functie-aanroep. Het retourtype sql_variant alle retourwaarden terugloopt.

• Expiry_Date en Start_Datedatum/tijd retourneren.
• Cert_Serial_Number, Issuer_Name, String_SID en Onderwerp retourneren allemaal nvarchar.
• SID retourneert varbinary.

Remarks

Zie de certificaatinformatie in de catalogusweergave sys.certificates .

Permissions

Vereist de juiste toestemming(en) op het certificaat en vereist dat de beller geen toestemming op het certificaat heeft gekregen VIEW . Zie CREATE CERTIFICATE (Transact-SQL) en GRANTCERTIFICATE PERMISSIONS (Transact-SQL) voor meer informatie over certificaatrechten.

Examples

In het volgende voorbeeld wordt het certificaatonderwerp geretourneerd.

-- First create a certificate.  
CREATE CERTIFICATE Marketing19 WITH   
    START_DATE = '04/04/2004' ,  
    EXPIRY_DATE = '07/07/2040' ,  
    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  

Zie ook

CREATE CERTIFICATE (Transact-SQL)
ALTER CERTIFICATE (Transact-SQL)
CERT_ID (Transact-SQL)Versleutelingshiërarchiesys.certificaten (Transact-SQL)Beveiligingscatalogusweergaven (Transact-SQL)