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

另請參閱

CERT_CONTEXT

CertGetCertificateContextProperty

擴充屬性函式