CTL_VERIFY_USAGE_STATUS結構 (wincrypt.h)

CTL_VERIFY_USAGE_STATUS 結構包含 CertVerifyCTLUsage 所傳回之憑證信任清單 (CTL) 的相關信息。

語法

typedef struct _CTL_VERIFY_USAGE_STATUS {
  DWORD          cbSize;
  DWORD          dwError;
  DWORD          dwFlags;
  PCCTL_CONTEXT  *ppCtl;
  DWORD          dwCtlEntryIndex;
  PCCERT_CONTEXT *ppSigner;
  DWORD          dwSignerIndex;
} CTL_VERIFY_USAGE_STATUS, *PCTL_VERIFY_USAGE_STATUS;

成員

cbSize

以位元組為單位的結構大小。 呼叫 CertVerifyCTLUsage 的應用程式會設定此參數。 如果 cbSize 不大於或等於結構的必要大小， CertVerifyCTLUsage 會傳回 FALSE ，而 GetLastError 會 傳回E_INVALIDARG。

dwError

如果有任何錯誤狀態，則為 CertVerifyCTLUsage 呼叫所傳回。 如需可能的錯誤值清單，請參閱 CertVerifyCTLUsage 中的傳回值一節。

dwFlags

如果 傳 回CERT_VERIFY_UPDATED_CTL_FLAG，CertVerifyCTLUsage 會更新 CTL，該 CTL 已不再使用新的有效時間 CTL。

ppCtl

包含相符主旨之 CTL 內容的 指標指標。 呼叫的應用程式可以將此指標設定為 NULL ，以指出未傳回包含主體的 CTL。

如果 ppCtl 不是 NULL，呼叫端應用程式必須使用 CertFreeCTLContext 釋放傳回的內容。

dwCtlEntryIndex

傳回 CTL 陣列中相符主體項目的陣列位置。

ppSigner

指向 CTL 簽署者之憑證內容的指標。 呼叫應用程式可以設定此指標為 NULL ，指出不會傳回 CTL 之簽署者的憑證。

如果 ppSigner 不是 NULL，呼叫端應用程式必須使用 CertFreeCTLContext 釋放傳回的內容。

dwSignerIndex

實際使用的簽署者索引。 如果訊息有一個以上的簽署者，則為必要項。

備註

呼叫應用程式應該將 dwError、 dwFlags、 dwCtlEntryIndex 和 dwSignerIndex 成員初始化為零。

規格需求

另請參閱

CERT_CONTEXT

CTL_CONTEXT

CertVerifyCTLUsage