CertProperty (Transact-SQL)

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

Siehe auch

Verweis