CERTPROPERTY (Transact-SQL)

Artículo
06/18/2013

Devuelve el valor de una propiedad de certificado especificada.

Icono de vínculo a temas Convenciones de sintaxis de Transact-SQL

Sintaxis

CertProperty ( Cert_ID , '<PropertyName>' )

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

Argumentos

Cert_ID
Es el id. del certificado. Cert_ID es de tipo int.
Expiry_Date
Es la fecha de expiración del certificado.
Start_Date
Es la fecha en que el certificado pasa a ser válido.
Issuer_Name
Es el nombre del emisor del certificado.
Cert_Serial_Number
Es el número de serie del certificado.
Subject
Es el asunto del certificado.
SID
Es el SID del certificado. También es el SID de cualquier inicio de sesión o usuario asignado a este certificado.
String_SID
Es el SID del certificado como una cadena de caracteres. También es el SID de cualquier inicio de sesión o usuario asignado al certificado.

Tipos de valor devueltos

La especificación de propiedad debe estar entre comillas simples.

El tipo devuelto depende de la propiedad especificada en la llamada de función. Todos los valores devueltos se agrupan en el tipo devuelto de sql_variant.

Expiry_Date y Start_Date devuelven datetime.
Cert_Serial_Number, Issuer_Name, Subject y String_SID devuelven nvarchar.
SID devuelve varbinary.

Comentarios

Para obtener más información acerca de certificados, vea la vista de catálogo sys.certificates.

Permisos

Requiere algunos permisos en el certificado y que el llamador no tenga denegado el permiso VIEW DEFINITION en el certificado.

Ejemplos

En el siguiente ejemplo se devuelve el asunto del certificado.

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