CERTPROPERTY (Transact-SQL)

Dotyczy:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceBaza danych SQL w usłudze Microsoft Fabric

Zwraca wartość określonej właściwości certyfikatu.

Transact-SQL konwencje składni

Syntax

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

Arguments

Cert_ID
Wartość identyfikatora certyfikatu typu danych int.

Expiry_Date
Data wygaśnięcia certyfikatu.

Start_Date
Data ważności certyfikatu.

Issuer_Name
Nazwa wystawcy certyfikatu.

Cert_Serial_Number
Numer seryjny certyfikatu.

Subject
Podmiot certyfikatu.

SID
Identyfikator SID certyfikatu. Jest to również identyfikator SID dowolnego identyfikatora logowania lub użytkownika zamapowanego na ten certyfikat.

String_SID
Identyfikator SID certyfikatu jako ciąg znaków. Jest to również identyfikator SID dowolnego identyfikatora logowania lub użytkownika mapowanego na certyfikat.

Typy zwracane

Pojedyncze znaki cudzysłowu muszą zawierać specyfikację właściwości.

Typ zwracany zależy od właściwości określonej w wywołaniu funkcji. Zwracany typ sql_variant opakowuje wszystkie zwracane wartości.

• Expiry_Date i Start_Datezwracać datę/godzinę.
• Cert_Serial_Number, Issuer_Name, String_SID i wszystkie podmioty zwracają nvarchar.
• Identyfikator SID zwraca wartość varbinary.

Remarks

Zobacz informacje o certyfikacie w widoku katalogu sys.certificates .

Permissions

Wymaga odpowiednich uprawnień w certyfikacie i wymaga, aby obiekt wywołujący nie odmówiono uprawnień WYŚWIETL w certyfikacie. Aby uzyskać więcej informacji na temat uprawnień certyfikatu, zobacz CREATE CERTIFICATE (Transact-SQL) i GRANT CERTIFICATE PERMISSIONS (Transact-SQL).

Examples

Poniższy przykład zwraca podmiot certyfikatu.

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

Zobacz także

UTWÓRZ CERTYFIKAT (Transact-SQL)
CERTYFIKAT ALTERA (Transact-SQL)
CERT_ID (Transact-SQL)Hierarchia szyfrowaniasys.certificates (Transact-SQL)Widoki wykazu zabezpieczeń (Transact-SQL)