enrollCommon
enrollmentCommon 資料夾包含憑證註冊 SDK 所提供的範例所使用的下列協助程式函式和宏。 預設會安裝在 %ProgramFiles%\Microsoft SDKs\Windows\v7.0\Samples\Security\X509 憑證註冊\VC\enrollmentCommon 資料夾中。
| 函式 | 描述 |
|---|---|
| _JumpIfError | 接受 HRESULT 值、標籤和錯誤字串、列印字串，並將程式控制項傳送至標籤後面的第一個語句的宏。 |
| _JumpError | 與_JumpIfError宏相同。 |
| _PrintIfError | 目前無法使用。 |
| _PrintError | 列印錯誤訊息和 HRESULT 值的宏。 |
| convertWszToSz | 使用 WideCharToMultiByte 函式和系統的目前 ANSI 字碼頁識別碼，將寬字元字串轉換為 ASCII 字元字串。 decConvertFromUnicode 會使用此函式，並尋找在 enrollCommon.cpp 中定義的OIDFromTemplateName 函式。 |
| convertSzToWsz | 使用 MultiByteToWideChar 函式和系統目前的 ANSI 字碼頁識別碼，將 ASCII 字串轉換為寬字元字串。 此函式是由 enrollCommon.cpp 中定義的 findCertByTemplate 函式所使用。 |
| convertSzToBstr | 使用MultiByteToWideChar函式，將 ASCII 字串轉換為BSTR。 目前未使用此函式。 |
| convertWszToBstr | 將寬字元字串轉換為 BSTR。 installResponseFromPFX 範例會使用此函式。 |
| checkEnrollStatus | 使用 IX509Enrollment 和 IX509EnrollmentStatus 介面檢查憑證註冊程式的狀態。 註冊EOBOCMC、enrollPKCS7、enrollRenewalPKCS7、enrollSimpleMachineCert 和 enrollSimpleUserCert 範例會使用此函式。 |
| findCertByKeyUsage | 列舉目前使用者的個人憑證存儲，以尋找預期使用公開金鑰符合指定值的第一個憑證。 指定的值可以是下列旗標的位元組合：
|
| findCertByEKU | 列舉目前使用者的個人憑證存儲，以尋找增強金鑰使用方式 (EKU) 擴充功能符合輸入上指定的第一個憑證。 如需 EKU 延伸模組的詳細資訊，請參閱 IX509ExtensionEnhancedKeyUsage 介面。 註冊EOBOCMC 範例會使用此函式。 |
| findCertByTemplate | 列舉目前使用者的個人憑證存儲，以尋找範本符合輸入時依名稱指定的第一個憑證。 註冊PKCS7 和 enrollRenewalPKCS7 範例會使用此函式。 |
| enrollCertByTemplate | 使用範本初始化 IX509Enrollment 物件、嘗試註冊隱含建立的憑證要求，以及監視註冊程式的狀態。 註冊EOBOCMC、enrollFromPublicKey、enrollPKCS7 和 enrollRenewalPKCS7 範例會使用此函式。 |
| verifyCertCoNtext | 根據指定的 (基底) 原則驗證憑證鏈結的合規性，並選擇性地根據指定的增強金鑰使用方式 (EKU) 延伸模組。 如需詳細資訊，請參閱 CertVerifyCertificateChainPolicy 函式和 CERT_CHAIN_POLICY_PARA 和 CERT_CHAIN_PARA 結構。 註冊EOBOCMC、enrollFromPublicKey、enrollPKCS7 和 enrollRenewalPKCS7 範例會使用此函式。 |
| decConvertFromUnicode | 將雙位元組 Unicode 字元的字串轉換為單一位元組 ANSI 字元的字串。 在 enrollCommon.cpp 中定義的 DecodeFileW 函式會使用此函式。 |
| DecodeFileW | 將編碼的憑證或憑證要求檔案解碼為位元組陣列。 installResponseFromPFX 範例會使用此函式。 |
| EncodeToFileW | 編碼憑證或憑證要求，並將它儲存至檔案。 createCNGCustomCMC、enrollEOBOCMC 和 enrollFromPublicKey 範例會使用此函式。 |
| findOIDFromTemplateName | 擷取名稱所指定範本的物件識別碼。 此函式是由 enrollCommon.cpp 中定義的 findCertByTemplate 函式所使用。 |