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 參數取得。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
標頭 | wincrypt.h |