Condividi tramite


enrollCommon

La cartella enrollCommon contiene le funzioni helper e le macro seguenti usate dagli esempi forniti con Certificate Enrollment SDK. Viene installato per impostazione predefinita nella cartella %ProgramFiles%\Microsoft SDKs\Windows\v7.0\Samples\Security\X509 Certificate Enrollment\VC\enrollCommon.

Funzione Descrizione
_JumpIfError Macro che accetta un valore HRESULT , un'etichetta e una stringa di errore, stampa la stringa e trasferisce il controllo programma alla prima istruzione dopo l'etichetta.
_JumpError Uguale alla macro _JumpIfError.
_PrintIfError Attualmente non utilizzato.
_PrintError Macro che stampa un messaggio di errore e un valore HRESULT .
convertWszToSz Converte una stringa di caratteri wide in una stringa di caratteri ASCII usando la funzione WideCharToMultiByte e l'identificatore della tabella codici ANSI corrente per il sistema. Questa funzione viene usata dalle funzioni decConvertFromUnicode e findOIDFromTemplateName definite in enrollCommon.cpp.
convertSzToWsz Converte una stringa ASCII in una stringa di caratteri wide utilizzando la funzione MultiByteToWideChar e l'identificatore della tabella codici ANSI corrente per il sistema. Questa funzione viene usata dalla funzione findCertByTemplate definita in enrollCommon.cpp.
convertSzToBstr Converte una stringa ASCII in una stringa BSTR usando la funzione MultiByteToWideChar . Questa funzione non è attualmente utilizzata.
convertWszToBstr Converte una stringa di caratteri wide in una stringa BSTR. Questa funzione viene usata dall'esempio installResponseFromPFX.
checkEnrollStatus Controlla lo stato del processo di registrazione certificati usando le interfacce IX509Enrollment e IX509EnrollmentStatus . Questa funzione viene usata dagli esempi enrollEOBOCMC, enrollPKCS7, enrollRenewalPKCS7, enrollSimpleMachineCert e enrollSimpleUserCert.
findCertByKeyUsage Enumera l'archivio certificati personale dell'utente corrente per trovare il primo certificato per il quale l'uso previsto della chiave pubblica corrisponde a un valore specificato. Il valore specificato può essere una combinazione bit per bit dei flag seguenti:
  • 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
Questa funzione viene usata dall'esempio enrollFromPublicKey.
findCertByEKU Enumera l'archivio certificati personale dell'utente corrente per trovare il primo certificato per il quale l'estensione EKU (Enhanced Key Usage) corrisponde a quella specificata nell'input. Per altre informazioni sull'estensione EKU, vedere l'interfaccia IX509ExtensionEnhancedKeyUsage . Questa funzione viene usata dall'esempio enrollEOBOCMC.
findCertByTemplate Enumera l'archivio certificati personale dell'utente corrente per trovare il primo certificato per il quale il modello corrisponde a quello specificato, in base al nome, all'input. Questa funzione viene usata dagli esempi enrollPKCS7 e enrollRenewalPKCS7.
enrollCertByTemplate Inizializza un oggetto IX509Enrollment usando un modello, tenta di registrare la richiesta di certificato creata in modo implicito e monitora lo stato del processo di registrazione. Questa funzione viene usata dagli esempi enrollEOBOCMC, enrollFromPublicKey, enrollPKCS7 e enrollRenewalPKCS7.
verifyCertContext Verifica la conformità della catena di certificati rispetto ai criteri (base) specificati e, facoltativamente, a fronte di un'estensione EKU (Enhanced Key Usage) specificata. Per altre informazioni, vedere la funzione CertVerifyCertificateChainPolicy e le strutture CERT_CHAIN_POLICY_PARA e CERT_CHAIN_PARA . Questa funzione viene usata dagli esempi enrollEOBOCMC, enrollFromPublicKey, enrollPKCS7 e enrollRenewalPKCS7.
decConvertFromUnicode Converte una stringa di caratteri Unicode a byte doppio in una stringa di caratteri ANSI a byte singolo. Questa funzione viene usata dalla funzione DecodeFileW definita in enrollCommon.cpp.
DecodeFileW Decodifica un certificato codificato o un file di richiesta di certificato in una matrice di byte. Questa funzione viene usata dall'esempio installResponseFromPFX.
EncodeToFileW Codifica un certificato o una richiesta di certificato e lo salva in un file. Questa funzione viene usata dagli esempi createCNGCustomCMC, enrollEOBOCMC e enrollFromPublicKey.
findOIDFromTemplateName Recupera l'identificatore dell'oggetto per un modello specificato in base al nome. Questa funzione viene usata dalla funzione findCertByTemplate definita in enrollCommon.cpp.

Uso degli esempi inclusi