Enumeração X509RequestInheritOptions (certenroll.h)

  • Artigo

O tipo de enumeração X509RequestInheritOptions especifica como chaves, valores de extensão e propriedades externas são herdados quando uma nova solicitação é criada a partir de um certificado existente. Essa enumeração pode ser usada para inicializar um objeto IX509CertificateRequestPkcs7 ou um objeto IX509CertificateRequestPkcs10 de um certificado existente.

Você pode escolher um dos seguintes valores para especificar como as chaves são herdadas:

  • InheritNewDefaultKey
  • InheritNewSimilarKey
  • InheritPrivateKey
  • InheritPublicKey
Você também pode usar uma operação bit a bit AND para combinar a opção de herança de chave com InheritNone ou com qualquer combinação dos seguintes sinalizadores:
  • InheritRenewalCertificateFlag
  • InheritTemplateFlag
  • InheritSubjectFlag
  • InheritExtensionsFlag
  • InheritSubjectAltNameFlag
  • InheritValidityPeriodFlag

Syntax

typedef enum X509RequestInheritOptions {
  InheritDefault = 0,
  InheritNewDefaultKey = 0x1,
  InheritNewSimilarKey = 0x2,
  InheritPrivateKey = 0x3,
  InheritPublicKey = 0x4,
  InheritKeyMask = 0xf,
  InheritNone = 0x10,
  InheritRenewalCertificateFlag = 0x20,
  InheritTemplateFlag = 0x40,
  InheritSubjectFlag = 0x80,
  InheritExtensionsFlag = 0x100,
  InheritSubjectAltNameFlag = 0x200,
  InheritValidityPeriodFlag = 0x400,
  InheritReserved80000000 = 0x80000000
} ;

Constantes

 
InheritDefault
Valor: 0
A herança não é especificada. Para obter mais informações, consulte o método InitializeFromCertificate na interface IX509CertificateRequestPkcs10 .
InheritNewDefaultKey
Valor: 0x1
Cria uma nova chave, mas herda o CSP ( provedor de serviço criptográfico ) ou KSP padrão.
InheritNewSimilarKey
Valor: 0x2
Cria uma nova chave, mas herda o CSP ou o KSP usado para criar o certificado existente.
InheritPrivateKey
Valor: 0x3
Herda as chaves privadas e públicas.
InheritPublicKey
Valor: 0x4
Herda apenas a chave pública.
InheritKeyMask
Valor: 0xf
Use para mascarar os 4 bits de ordem inferior que identificam a herança de chave.
InheritNone
Valor: 0x10
Impede o uso dos seguintes valores de herança:


  • InheritRenewalCertificateFlag

  • InheritTemplateFlag

  • InheritSubjectFlag

  • InheritExtensionsFlag

  • InheritSubjectAltNameFlag

  • InheritValidityPeriodFlag
InheritRenewalCertificateFlag
Valor: 0x20
Herda o certificado de renovação. Especificar esse sinalizador define um valor ICertPropertyRenewal .
InheritTemplateFlag
Valor: 0x40
Herda o modelo de certificado.
InheritSubjectFlag
Valor: 0x80
Herda o nome diferenciado da entidade.
InheritExtensionsFlag
Valor: 0x100
Herda as extensões relevantes do certificado. Os valores de extensão associados aos seguintes identificadores de objeto não são herdados:


  • XCN_OID_CERTSRV_CA_VERSION

  • XCN_OID_AUTHORITY_INFO_ACCESS

  • XCN_OID_CRL_DIST_POINTS

  • XCN_OID_AUTHORITY_KEY_IDENTIFIER2

  • XCN_OID_CERTSRV_PREVIOUS_CERT_HASH

  • XCN_OID_ENROLL_CERTTYPE_EXTENSION

  • XCN_OID_CERTIFICATE_TEMPLATE
InheritSubjectAltNameFlag
Valor: 0x200
Herda a extensão SubjectAlternativeName .
InheritValidityPeriodFlag
Valor: 0x400
Herda o período de validade.
InheritReserved80000000
Valor: 0x80000000

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho certenroll.h

Confira também

Enumerações CertEnroll

CertEnroll Interfaces

IX509CertificateRequestPkcs10

IX509CertificateRequestPkcs7