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