Funzione CertAddEncodedCertificateToSystemStoreA (wincrypt.h)

Articolo
11/20/2024

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 non riesce, il valore restituito viene FALSE. CertAddEncodedCertificateToSystemStore dipende dalle funzioni elencate nelle note seguenti per la gestione degli errori. Per i rispettivi comportamenti di gestione degli errori, vedere gli argomenti relativi alle funzioni. Per informazioni sugli errori estesi, chiamare GetLastError.

Osservazioni

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

parametro CertOpenSystemStore	Valore
szSubsystemProtocol	szCertStoreName

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

parametro CertAddEncodedCertificateToStore	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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	wincrypt.h
libreria	Crypt32.lib
dll	Crypt32.dll

Condividi tramite