CERTPROPERTY (Transact-SQL)

platí pro:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceSQL databáze v Microsoft Fabric

Vrátí hodnotu zadané vlastnosti certifikátu.

Transact-SQL konvence syntaxe

Syntax

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

Arguments

Cert_ID
Hodnota ID certifikátu datového typu int.

Expiry_Date
Datum vypršení platnosti certifikátu.

Start_Date
Datum, kdy se certifikát stane platným.

Issuer_Name
Název vystavitele certifikátu.

Cert_Serial_Number
Sériové číslo certifikátu.

Subject
Předmět certifikátu.

SID
Identifikátor SID certifikátu. Toto je také IDENTIFIKÁTOR SID jakéhokoli přihlášení nebo uživatele namapovaného na tento certifikát.

String_SID
Identifikátor SID certifikátu jako řetězec znaků. Toto je také identifikátor SID libovolného přihlášení nebo uživatele namapovaného na certifikát.

Návratové typy

Jednoduché uvozovky musí uzavřít specifikaci vlastnosti.

Návratový typ závisí na vlastnosti zadané ve volání funkce. Návratový typ sql_variant zabalí všechny vrácené hodnoty.

  • Expiry_Date a Start_Date vrátit datum a čas.
  • Cert_Serial_Number, Issuer_Name, String_SID a Předmět vrátí nvarchar.
  • Identifikátor SID vrátí varbinary.

Remarks

Viz informace o certifikátu v zobrazení katalogu sys.certificates .

Permissions

Vyžaduje příslušná oprávnění na certifikát a vyžaduje, aby volající nebyl odepřen VIEW přístup k certifikátu. Viz CREATE CERTIFICATE (Transact-SQL) a GRANTCERTIFICATE OPRÁVNĚNÍ (Transact-SQL) pro více informací o oprávněních certifikátů.

Examples

Následující příklad vrátí předmět certifikátu.

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

Viz také

CREATE CERTIFICATE (Transact-SQL)
ALTER CERTIFICATE (Transact-SQL)
CERT_ID (Transact-SQL)Sys.certificates (Transact-SQL)Zobrazení katalogu zabezpečení (Transact-SQL)

  • Last updated on