Funzione CertAddEncodedCertificateToSystemStoreA (wincrypt.h)

Articolo
03/15/2023

La funzione CertAddEncodedCertificateToSystemStore apre l'archivio di sistema specificato e aggiunge il certificato codificato.

Sintassi

BOOL CertAddEncodedCertificateToSystemStoreA(
  [in] LPCSTR     szCertStoreName,
  [in] const BYTE *pbCertEncoded,
  [in] DWORD      cbCertEncoded
);

Parametri

[in] szCertStoreName

Stringa con terminazione null contenente il nome dell'archivio di sistema per il certificato codificato.

[in] pbCertEncoded

Puntatore a un buffer contenente il certificato codificato da aggiungere.

[in] cbCertEncoded

Dimensioni, in byte, del buffer pbCertEncoded .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è TRUE.

Se la funzione ha esito negativo, il valore restituito è FALSE. CertAddEncodedCertificateToSystemStore dipende dalle funzioni elencate nelle osservazioni seguenti per la gestione degli errori. Fare riferimento a tali argomenti di funzione per i rispettivi comportamenti di gestione degli errori. Per informazioni sull'errore estese, chiamare GetLastError.

Commenti

Internamente, CertAddEncodedCertificateToSystemStore chiama CertOpenSystemStore e CertAddEncodedCertificateToStore con i parametri seguenti.

CertOpenSystemStore Parametro	Valore
szSubsystemProtocol	szCertStoreName

Se CertAddEncodedCertificateToSystemStore ottiene un handle nell'archivio di sistema specificato, chiama CertCloseStore per chiudere l'handle prima che venga restituito.

CertAddEncodedCertificateToStore Parametro	Valore
dwCertEncodingType	X509_ASN_ENCODING
dwAddDisposition	CERT_STORE_ADD_USE_EXISTING
ppCertContext	NULL

Nota

L'intestazione wincrypt.h definisce CertAddEncodedCertificateToSystemStore come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wincrypt.h
Libreria	Crypt32.lib
DLL	Crypt32.dll