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 HRESULT valor, 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 uma 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 interfaceIX509ExtensionEnhancedKeyUsage. 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, pelo 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 o 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 de EKU (Uso Avançado de Chave) especificada. Para obter mais informações, consulte a funçãoCertVerifyCertificateChainPolicy 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 arquivo de solicitação de certificado ou certificado codificado para uma matriz de bytes. Essa função é usada pelo exemplo installResponseFromPFX.
EncodeToFileW Codifica um certificado ou solicitação de certificado e o 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