CERTPROPERTY (Transact-SQL)

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Devuelve el valor de una propiedad de certificado especificada.

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
El valor del identificador de certificado, con el tipo de datos int.

Expiry_Date
La fecha de expiración del certificado.

Start_Date
La fecha en la que el certificado pasa a ser válido.

Issuer_Name
El nombre del emisor de certificado.

Cert_Serial_Number
El número de serie del certificado.

Subject
El asunto del certificado.

SID
El SID del certificado. También es el SID de cualquier inicio de sesión o usuario asignado a este certificado.

String_SID
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 valores devueltos

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

El tipo de valor devuelto depende de la propiedad especificada en la llamada de función. El tipo de valor devuelto sql_variant encapsula todos los valores devueltos.

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

Comentarios

Consulte la información de los certificados en la vista de catálogo sys.certificates.

Permisos

Es necesario tener los permisos apropiados en el certificado y que el autor de la llamada no tenga denegado el permiso VIEW en el certificado. Vea CREATE CERTIFICATE (Transact-SQL) y GRANT CERTIFICATE PERMISSIONS (Transact-SQL) para obtener más información sobre los permisos de 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/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  

Vea también

CREATE CERTIFICATE (Transact-SQL)
ALTER CERTIFICATE (Transact-SQL)
CERT_ID (Transact-SQL)Jerarquía de cifradosys.certificates (Transact-SQL)Vistas de catálogo de seguridad (Transact-SQL)