CertAddStoreToCollection 函式 (wincrypt.h)
CertAddStoreToCollection 函式會將同層級證書存儲新增至集合證書存儲。 將證書存儲新增至集合存放區時，可以使用使用集合存放區之尋找或列舉函式呼叫來擷取所有憑證、 證書吊銷清單 (CRL) ，以及憑證 信任清單 (C) CL。
語法
BOOL CertAddStoreToCollection(
[in] HCERTSTORE hCollectionStore,
[in, optional] HCERTSTORE hSiblingStore,
[in] DWORD dwUpdateFlags,
[in] DWORD dwPriority
);
參數
[in] hCollectionStore
證書存儲的句柄。
[in, optional] hSiblingStore
要加入至集合存放區的同層級存放區句柄。 如需詳細資訊，請參閱＜備註＞。
[in] dwUpdateFlags
指出是否可以將 憑證、CRL 和 CCL 新增至集合存放區的新同層級存放區成員。 若要啟用新增功能，請將 dwUpdateFlag 設定為 CERT_PHYSICAL_STORE_ADD_ENABLE_FLAG。 若要停用新增專案，請將 dwUpdateFlag 設定為零。
[in] dwPriority
設定集合中新存放區的優先順序級，其中零是最低優先順序。 如果為此參數傳遞零，則指定的存放區會附加為集合中的最後一個存放區。 集合中存放區的優先順序層級會決定列舉存放區的順序，以及在嘗試擷取憑證、CRL 或 CTL 時，存放區的搜尋順序。 優先順序層級也會決定要加入新憑證、CRL 或 CTL 之集合的存放區。 如需詳細資訊，請參閱＜備註＞。
傳回值
如果函式成功，函式會傳回非零，並將新的存放區新增至存放區的集合。
如果函式失敗，它會傳回零，而且未新增存放區。
備註
集合存放區與單一存放區具有相同 的 HCERTSTORE 句柄;因此，幾乎所有套用至任何 證書存儲 的函式也適用於任何集合存放區。 列舉和搜尋程式會跨越集合存放區中的所有存放區;不過，新增存放區連結的 CertAddCertificateLinkToStore 之類的函式無法與集合存放區搭配使用。
將憑證、CRL 或 CTL 新增至集合存放區時，會優先搜尋集合中的同層級存放區清單，以尋找允許新增的第一個存放區。 如果在 CertAddStoreToCollection 呼叫中設定CERT_PHYSICAL_STORE_ADD_ENABLE_FLAG，則會啟用新增。 使用任何新增元素至存放區的函式時，如果允許新增的存放區不會傳回成功，則加法函式會繼續下一個存放區，而不會提供通知。
當使用 CERT_CLOSE_STORE_FORCE_FLAG 的 CertCloseStore 關閉集合存放區及其同層級存放區時，必須在其同層級存放區之前關閉集合存放區。 如果未使用CERT_CLOSE_STORE_FORCE_FLAG，則可以依任何順序關閉商店。
範例
下列範例示範如何將同層級證書存儲新增至集合證書存儲。 如需完整範例，包括此範例的完整內容，請參閱 範例 C 程式：集合和同層級證書存儲作業。
//-------------------------------------------------------------------
// Declare and initialize variables.
HCERTSTORE hCollectionStore = NULL; // The collection store
// handle
HCERTSTORE hMemoryStore = NULL; // A memory store handle
LPCSTR pszFileName = "TestStor.sto"; // Output file name
LPWSTR pswzFirstCert = L"Full Test Cert";// Subject of the first
// certificate
LPWSTR pswzSecondCert = L"Microsoft"; // Subject of the second
// certificate
//-------------------------------------------------------------------
// Open a collection certificate store.
if(hCollectionStore = CertOpenStore(
CERT_STORE_PROV_COLLECTION, // A collection store
0, // Encoding type; not used with a
// collection store
NULL, // Use the default provider
0, // No flags
NULL)) // Not needed
{
printf("The collection store was opened. \n");
}
else
{
printf( "There was an error while opening the "
"collection store! \n");
exit(1);
}
//-------------------------------------------------------------------
// Open a new certificate store in memory.
if(hMemoryStore = CertOpenStore(
CERT_STORE_PROV_MEMORY, // A memory store
0, // Encoding type; not used with a
// memory store
NULL, // Use the default provider
0, // No flags
NULL)) // Not needed
{
printf("The memory store was opened. \n");
}
else
{
printf( "There was an error while opening the memory store! \n");
exit(1);
}
//-------------------------------------------------------------------
// Add the memory store as a sibling to the collection store.
// All certificates in the memory store and any new certificate
// added to the memory store will also be available in the
// collection
// store.
if(CertAddStoreToCollection(
hCollectionStore,
hMemoryStore,
CERT_PHYSICAL_STORE_ADD_ENABLE_FLAG, // New certificates can be
// added to the sibling
// store.
1)) // The sibling store's
// priority.
// Because this is the
// store with the highest
// priority, certificates
// added to the collection
// store will actually be
// stored in this store.
{
printf("The memory store was added to the collection store.\n");
}
else
{
printf("The memory store was not added to the "
"collection store.\n");
exit(1);
}
//-------------------------------------------------------------------
// The store handles must be closed.
if(CertCloseStore(hCollectionStore,
0))
{
printf("The collection store was closed. \n");
}
else
{
printf("There was an error while closing the "
"collection store! \n");
}
if(CertCloseStore(hMemoryStore, 0))
{
printf("The memory store was closed. \n");
}
else
{
printf("There was an error while closing the memory store! \n");
}
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | wincrypt.h |
| 程式庫 | Crypt32.lib |
| Dll | Crypt32.dll |