CertProperty (Transact-SQL)

Gibt den Wert einer angegebenen Zertifikateigenschaft zurück.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

CertProperty ( Cert_ID , '<PropertyName>' )

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

Argumente

  • Cert_ID
    Die ID des Zertifikats. Cert_ID ist eine ganze Zahl.

  • Expiry_Date
    Das Ablaufdatum des Zertifikats.

  • Start_Date
    Das Datum, an dem das Zertifikat gültig wird.

  • Issuer_Name
    Der Name des Zertifikatausstellers.

  • Cert_Serial_Number
    Die Seriennummer des Zertifikats.

  • Subject
    Der Zertifikatsantragsteller.

  • SID
    Die SID des Zertifikats. Dies ist auch die SID eines diesem Zertifikat zugeordneten Anmeldenamens oder Benutzers.

  • String_SID
    Die SID des Zertifikats als Zeichenfolge. Dies ist auch die SID eines diesem Zertifikat zugeordneten Anmeldenamens oder Benutzers.

Rückgabetypen

Die Angabe der Eigenschaft muss in einfache Anführungszeichen eingeschlossen werden.

Der Rückgabetyp hängt von der im Funktionsaufruf angegebenen Eigenschaft ab. Alle Rückgabewerte werden in den Rückgabetyp sql_variant eingebunden.

  • Expiry_Date und Start_Date geben datetime zurück.

  • Cert_Serial_Number, Issuer_Name, Subject und String_SID geben nvarchar zurück.

  • SID gibt varbinary zurück.

Hinweise

Informationen zu Zertifikaten werden in der sys.certificates-Katalogsicht angezeigt.

Berechtigungen

Erfordert bestimmte Berechtigungen für das Zertifikat, und dem Aufrufer darf die VIEW DEFINITION-Berechtigung für das Zertifikat nicht verweigert worden sein.

Beispiele

Im folgenden Beispiel wird der Zertifikatsantragsteller zurückgegeben.

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