CTL_FIND_USAGE_PARA 結構 (wincrypt.h)

CTL_FIND_USAGE_PARA 結構是 CTL_FIND_SUBJECT_PARA 結構的成員，並由 CertFindCTLInStore 使用。

語法

typedef struct _CTL_FIND_USAGE_PARA {
  DWORD           cbSize;
  CTL_USAGE       SubjectUsage;
  CRYPT_DATA_BLOB ListIdentifier;
  PCERT_INFO      pSigner;
} CTL_FIND_USAGE_PARA, *PCTL_FIND_USAGE_PARA;

成員

cbSize

這個結構的大小，以位元組為單位。

SubjectUsage

CTL_USAGE 結構，其中包含在尋找 CTL (CTL) 憑證 信任清單 時要比對的物件識別符序列。

找到的 CTL 必須包含 SubjectUsage 成員所指定的所有使用物件識別碼。

如果這個結構的 cUsageIdentifier 成員為零，則任何使用方式的 CTL 都可以相符。

ListIdentifier

指定以將搜尋限制為特定的簽署者 CTL 清單。 通常 ListIdentifier 成員會是零，表示任何 ListIdentifier 都可以比對。 如果不是零，CTL 中的這個 ListIdentifier 和 ListIdentifier 必須相符。

若要只比對沒有 ListIdentifier 的 CCL，ListIdentifier 的 cbData 成員會設定為 CTL_FIND_NO_LIST_ID_CBDATA。

CTL 使用 ListIdentifier 來區分相同簽發者與相同 SubjectUsage 所建立的多個 CCL。

pSigner

CERT_INFO 結構的指標，指定要比對的 CTL 簽署者。 只有 來自CERT_INFO 的簽發者和序號會用來比對簽署者。

將 pSigner 設定為 NULL 以符合任何簽署者。 若要比對沒有任何簽署者的 CCL，請將 pSigner 設定為 CTL_FIND_NO_SIGNER_PTR。

簽署者的 CertEncodingType 是從 CertFindCTLInStore 的 dwMsgAndCertEncodingType 參數取得。

規格需求

另請參閱

CERT_INFO

CRYPT_INTEGER_BLOB

CTL_FIND_SUBJECT_PARA

CTL_USAGE

CertFindCTLInStore