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:
|
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. |