Compartilhar via


enrollCommon

A pasta enrollCommon contém as seguintes funções auxiliares e macros usadas pelos exemplos fornecidos com o SDK de Registro de Certificado. Ele é instalado por padrão na pasta %ProgramFiles%\Microsoft SDKs\Windows\v7.0\Samples\Security\X509 Certificate Enrollment\VC\enrollCommon.

Função Descrição
_JumpIfError Macro que aceita um valor HRESULT , um rótulo e uma cadeia de caracteres de erro, imprime a cadeia de caracteres e transfere o controle do programa para a primeira instrução após o rótulo.
_JumpError O mesmo que a macro _JumpIfError.
_PrintIfError Não usado no momento.
_PrintError Macro que imprime uma mensagem de erro e um valor HRESULT .
convertWszToSz Converte uma cadeia de caracteres largos em uma cadeia de caracteres ASCII usando a função WideCharToMultiByte e o identificador de página de código ANSI atual para o sistema. Essa função é usada pelas funções decConvertFromUnicode e findOIDFromTemplateName definidas em enrollCommon.cpp.
convertSzToWsz Converte uma cadeia de caracteres ASCII em uma cadeia de caracteres largos usando a função MultiByteToWideChar e o identificador de página de código ANSI atual para o sistema. Essa função é usada pela função findCertByTemplate definida em enrollCommon.cpp.
convertSzToBstr Converte uma cadeia de caracteres ASCII em um BSTR usando a função MultiByteToWideChar . Essa função não é usada no momento.
convertWszToBstr Converte uma cadeia de caracteres largos em um BSTR. Essa função é usada pelo exemplo installResponseFromPFX.
checkEnrollStatus Verifica o status do processo de registro de certificado usando as interfaces IX509Enrollment e IX509EnrollmentStatus. Essa função é usada pelos exemplos enrollEOBOCMC, enrollPKCS7, enrollRenewalPKCS7, enrollSimpleMachineCert e enrollSimpleUserCert.
findCertByKeyUsage Enumera o repositório de certificados pessoal do usuário atual para localizar o primeiro certificado para o qual o uso pretendido da chave pública corresponde a um valor especificado. O valor especificado pode ser uma combinação bit a bit dos seguintes sinalizadores:
  • CERT_DATA_ENCIPHERMENT_KEY_USAGE
  • CERT_DIGITAL_SIGNATURE_KEY_USAGE
  • CERT_KEY_AGREEMENT_KEY_USAGE
  • CERT_KEY_CERT_SIGN_KEY_USAGE
  • CERT_KEY_ENCIPHERMENT_KEY_USAGE
  • CERT_NON_REPUDIATION_KEY_USAGE
  • CERT_OFFLINE_CRL_SIGN_KEY_USAGE
Essa função é usada pelo exemplo enrollFromPublicKey.
findCertByEKU Enumera o repositório de certificados pessoal do usuário atual para localizar o primeiro certificado para o qual a extensão EKU (Uso Avançado de Chave) corresponde à especificada na entrada. Para obter mais informações sobre a extensão de EKU, consulte a interface IX509ExtensionEnhancedKeyUsage . Essa função é usada pelo exemplo enrollEOBOCMC.
findCertByTemplate Enumera o repositório de certificados pessoal do usuário atual para localizar o primeiro certificado para o qual o modelo corresponde ao especificado, por nome, na entrada. Essa função é usada pelos exemplos enrollPKCS7 e enrollRenewalPKCS7.
enrollCertByTemplate Inicializa um objeto IX509Enrollment usando um modelo, tenta registrar a solicitação de certificado criada implicitamente e monitora a status do processo de registro. Essa função é usada pelos exemplos enrollEOBOCMC, enrollFromPublicKey, enrollPKCS7 e enrollRenewalPKCS7.
verifyCertContext Verifica a conformidade da cadeia de certificados em relação à política (base) especificada e, opcionalmente, em relação a uma extensão EKU (Uso Avançado de Chave) especificada. Para obter mais informações, consulte a função CertVerifyCertificateChainPolicy e as estruturas CERT_CHAIN_POLICY_PARA e CERT_CHAIN_PARA . Essa função é usada pelos exemplos enrollEOBOCMC, enrollFromPublicKey, enrollPKCS7 e enrollRenewalPKCS7.
decConvertFromUnicode Converte uma cadeia de caracteres Unicode de byte duplo em uma cadeia de caracteres ANSI de byte único. Essa função é usada pela função DecodeFileW definida em enrollCommon.cpp.
DecodeFileW Decodifica um certificado codificado ou um arquivo de solicitação de certificado para uma matriz de bytes. Essa função é usada pelo exemplo installResponseFromPFX.
EncodeToFileW Codifica uma solicitação de certificado ou certificado e a salva em um arquivo. Essa função é usada pelos exemplos createCNGCustomCMC, enrollEOBOCMC e enrollFromPublicKey.
findOIDFromTemplateName Recupera o identificador de objeto para um modelo especificado pelo nome. Essa função é usada pela função findCertByTemplate definida em enrollCommon.cpp.

Usando os exemplos incluídos