CertProperty (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 caducidad 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.

Notas

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

Vea también

Referencia