CertAddCertificateLinkToStore 函式 (wincrypt.h)
CertAddCertificateLinkToStore 函式會將證書存儲中的連結新增至不同存放區中的憑證內容。 此函式不會建立和新增憑證內容的重複專案，而是將連結新增至原始憑證。
語法
BOOL CertAddCertificateLinkToStore(
[in] HCERTSTORE hCertStore,
[in] PCCERT_CONTEXT pCertContext,
[in] DWORD dwAddDisposition,
[out, optional] PCCERT_CONTEXT *ppStoreContext
);
參數
[in] hCertStore
要在其中新增連結之 證書存儲 的句柄。
[in] pCertContext
要連結 之CERT_CONTEXT 結構的指標。
[in] dwAddDisposition
如果相符的憑證或相符憑證的連結已存在於存放區中，則指定動作。 目前定義的處置值及其用途如下。
| 值 | 意義 |
|---|---|
|
函式不會檢查現有的相符憑證，或連結至相符的憑證。 新的憑證一律會新增至存放區。 這可能會導致存放區中的重複專案。 |
|
如果相符的憑證或相符憑證的連結存在，作業就會失敗。 GetLastError 會傳回CRYPT_E_EXISTS程序代碼。 |
|
如果相符憑證的連結存在，就會刪除該現有連結，並建立新的連結並新增至存放區。 如果沒有相符的憑證或相符憑證的連結存在，就會新增一個憑證。 |
|
如果相符的憑證或相符憑證的連結存在，則會使用現有的憑證。 函式不會失敗，但不會新增任何新連結。 如果沒有相符的憑證或相符憑證的連結存在，就會新增新的連結。 |
[out, optional] ppStoreContext
所建立連結複本之指標的指標。 ppStoreContext 參數可以是 NULL，表示不需要連結的複本。 如果建立連結的複本，則必須使用 CertFreeCertificateContext 函式釋放該複本。
傳回值
如果函式成功，則傳回值為 TRUE。
如果函式失敗，則傳回值為 FALSE。 如需擴充錯誤資訊，請呼叫 GetLastError。 以下是一些可能的錯誤碼。
| 傳回碼 | Description |
|---|---|
|
對於 CERT_STORE_ADD_NEW 的 dwAddDisposition 參數，憑證已存在於存放區中。 |
|
dwAddDisposition 參數中指定了無效的處置值。 |
備註
因為連結提供原始憑證 內容的存取權，所以在連結 的憑證內容中 設定擴充屬性會變更憑證原始位置中的擴充屬性，以及該憑證的任何其他連結。
鏈接無法新增至開啟為集合的存放區。 以集合形式開啟的存放區包括使用 CERT_STORE_PROV_SYSTEM 或 CERT_STORE_PROV_COLLECTION 以 CertOpenSystemStore 或 CertOpenStore 開啟的所有存放區。 如需詳細資訊，請參閱 CertAddStoreToCollection。
如果使用連結，且 使用 CERT_CLOSE_STORE_FORCE_FLAG呼叫 CertCloseStore ，則必須先關閉使用連結的存放區，才能關閉包含原始內容的存放區。 如果未使用CERT_CLOSE_STORE_FORCE_FLAG，則可以依任一順序關閉這兩個商店。
若要從證書存儲移除憑證內容連結，請使用 CertDeleteCertificateFromStore 函式。
範例
如需使用此函式的範例，請參閱 範例 C 程式：證書存儲作業。 如需使用此函式的其他程式碼，請參閱 範例 C 程式：集合和同層級證書存儲作業。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | wincrypt.h |
| 程式庫 | Crypt32.lib |
| Dll | Crypt32.dll |