Compartilhar via


CERTPROPERTY (Transact-SQL)

Retorna o valor de uma propriedade de certificado especificada.

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

CertProperty ( Cert_ID , '<PropertyName>' )

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

Argumentos

  • Cert_ID
    É a ID do certificado. Cert_ID é um inteiro.

  • Expiry_Date
    É a data de expiração do certificado.

  • Start_Date
    É a data em que o certificado se torna válido.

  • Issuer_Name
    É o nome do emissor do certificado.

  • Cert_Serial_Number
    É o número de série do certificado.

  • Subject
    É o assunto do certificado.

  • SID
    É o SID do certificado. Também é o SID de qualquer logon ou usuário mapeado para esse certificado.

  • String_SID
    É o SID do certificado como uma cadeia de caracteres. Também é o SID de qualquer logon ou usuário mapeado para o certificado.

Tipos de retorno

A especificação de propriedade deve ser incluída entre aspas simples.

O tipo de retorno depende da propriedade especificada na chamada de função. Todos os valores de retorno são encapsulados no tipo de retorno de sql_variant.

  • Expiry_Date e Start_Date retornam datetime.

  • Cert_Serial_Number, Issuer_Name, Subject e String_SID retornam nvarchar.

  • SID retorna varbinary.

Comentários

As informações sobre certificados são visíveis na exibição do catálogo sys.certificates.

Permissões

Requer algumas permissões no certificado e que a permissão VIEW DEFINITION não seja negada ao chamador no certificado.

Exemplos

O exemplo a seguir retorna o assunto do 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

Consulte também

Referência

CREATE CERTIFICATE (Transact-SQL)

ALTER CERTIFICATE (Transact-SQL)

CERT_ID (Transact-SQL)

sys.certificates (Transact-SQL)

Exibições do catálogo de segurança (Transact-SQL)

Conceitos

Hierarquia de criptografia