CertCreateCertificateCoNtext 函式 (wincrypt.h)

發行項
08/27/2023

CertCreateCertificateCoNtext函式會從編碼的憑證建立憑證內容。建立的內容不會保存到憑證存放區。函式會在建立的內容中建立編碼憑證的複本。

語法

PCCERT_CONTEXT CertCreateCertificateContext(
  [in] DWORD      dwCertEncodingType,
  [in] const BYTE *pbCertEncoded,
  [in] DWORD      cbCertEncoded
);

參數

[in] dwCertEncodingType

指定使用的編碼類型。將憑證和訊息編碼類型與位OR 作業結合在一起，一律可以接受，如下列範例所示：

X509_ASN_ENCODING |PKCS_7_ASN_ENCODING目前定義的編碼類型如下：

X509_ASN_ENCODING
PKCS_7_ASN_ENCODING

[in] pbCertEncoded

緩衝區的指標，其中包含要從中建立內容的編碼憑證。

[in] cbCertEncoded

pbCertEncoded緩衝區的大小，以位元組為單位。

傳回值

如果函式成功，函式會傳回唯讀 CERT_CONTEXT的指標。當您完成使用憑證內容時，請呼叫 CertFreeCertificateCoNtext 函式來釋放它。

如果函式無法解碼並建立憑證內容，則會傳回 Null。如需擴充錯誤資訊，請呼叫 GetLastError。以下是一些可能的錯誤碼。

傳回碼	描述
E_INVALIDARG	指定不正確憑證編碼類型。目前僅支援X509_ASN_ENCODING類型。

如果函式失敗， GetLastError 可能會傳回抽象語法標記法一 (ASN.1) 編碼/解碼錯誤。如需這些錯誤的相關資訊，請參閱 ASN.1 編碼/解碼傳回值。

備註

CERT_CONTEXT必須透過呼叫CertFreeCertificateCoNtext來釋出。您可以呼叫 CertDuplicateCertificateCoNtext 來建立重複專案。您可以呼叫 CertSetCertificateCoNtextProperty 和 CertGetCertificateCoNtextProperty 來儲存和讀取憑證的屬性。

範例

下列範例示範如何從編碼憑證建立憑證內容。建立的內容不會放在憑證存放區中。如需使用此函式的另一個範例，請參閱範例 C 程式：憑證存放區作業。

#include <windows.h>
#include <stdio.h>
#include <Wincrypt.h>

#define MY_ENCODING_TYPE  (PKCS_7_ASN_ENCODING | X509_ASN_ENCODING)

void main()
{
	PCCERT_CONTEXT  pCertContext = NULL; 

	//------------------------------------------------------------------ 
	//  Create a new certificate from the encoded part of
	//  an available certificate. pDesiredCert is a previously
	//  assigned PCCERT_CONTEXT variable.
	if(pCertContext = CertCreateCertificateContext(
		MY_ENCODING_TYPE,              // The encoding type
		pDesiredCert->pbCertEncoded,   // The encoded data from
									   // the certificate retrieved
		pDesiredCert->cbCertEncoded))  // The length of the encoded data
	{
		printf("A new certificate has been created.\n");
	 
		// Use the certificate context as needed.
		// ...

		// When finished, free the certificate context.
		CertFreeCertificateContext(pCertContext);
	}
	else
	{
		printf("A new certificate could not be created.\n");
		exit(1);
	}
}

規格需求


最低支援的用戶端	Windows XP [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2003 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	wincrypt.h
程式庫	Crypt32.lib
Dll	Crypt32.dll