CERTPROPERTY (Transact-SQL)

Se aplica a:SQL ServerAzure SQL DatabaseInstancia administrada de Azure SQLBase de datos SQL en Microsoft Fabric

Devuelve el valor de una propiedad de certificado especificada.

Convenciones de sintaxis de Transact-SQL

Syntax

CertProperty ( Cert_ID , '<PropertyName>' )  
  
<PropertyName> ::=  
   Expiry_Date | Start_Date | Issuer_Name   
   | Cert_Serial_Number | Subject | SID | String_SID   

Arguments

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 retorno

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.

Remarks

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

Permissions

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.

Examples

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  

Consulte también

CREAR CERTIFICADO (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)