CertEnumCertificateContextProperties 函式 (wincrypt.h)
CertEnumCertificateContextProperties 函式會擷取與憑證內容相關聯的第一個或下一個擴充屬性。 在迴圈中使用,此函式可以依序擷取與 憑證內容相關聯的所有擴充屬性。
語法
DWORD CertEnumCertificateContextProperties(
[in] PCCERT_CONTEXT pCertContext,
[in] DWORD dwPropId
);
參數
[in] pCertContext
憑證 CERT_CONTEXT 結構的指標,其中包含要列舉的屬性。
[in] dwPropId
最後一個列舉屬性的屬性編號。 若要取得第一個屬性, dwPropId 為零。 若要擷取後續屬性, dwPropId 會設定為最後一次呼叫函式所傳回的屬性編號。 若要列舉所有屬性,函數調用會繼續,直到函式傳回零為止。
應用程式可以使用此函式所傳回的 dwPropId 呼叫 CertGetCertificateContextProperty,以擷取該屬性的數據。
傳回值
傳回值是識別憑證內容屬性的DWORD 值。 函式的一個呼叫所傳回的 DWORD 值,可以在後續呼叫函式時提供為 dwPropId 。 如果沒有其他要列舉的屬性,或函式失敗,則會傳回零。
備註
CERT_KEY_PROV_HANDLE_PROP_ID和CERT_KEY_SPEC_PROP_ID屬性會儲存為 CERT_KEY_CONTEXT_PROP_ID 屬性的成員。 它們不會個別列舉。
範例
請參閱 範例 C 程式:列出存放區中的憑證。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2003 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | wincrypt.h |
程式庫 | Crypt32.lib |
Dll | Crypt32.dll |