Funzione CertSerializeCertificateStoreElement (wincrypt.h)

Articolo
08/27/2023

La funzione CertSerializeCertificateStoreElement serializza il certificato codificato di un contesto di certificato e le relative proprietà codificate. Il risultato può essere salvato in modo permanente nell'archiviazione in modo che il certificato e le proprietà possano essere recuperate in un secondo momento.

Sintassi

BOOL CertSerializeCertificateStoreElement(
  [in]      PCCERT_CONTEXT pCertContext,
  [in]      DWORD          dwFlags,
  [out]     BYTE           *pbElement,
  [in, out] DWORD          *pcbElement
);

Parametri

[in] pCertContext

Puntatore al CERT_CONTEXT da serializzare.

[in] dwFlags

Riservato per uso futuro e deve essere zero.

[out] pbElement

Puntatore a un buffer che riceve l'output serializzato, incluso il certificato codificato ed eventualmente le relative proprietà.

Questo parametro può essere NULL per impostare le dimensioni di queste informazioni ai fini dell'allocazione della memoria. Per altre informazioni, vedere Recupero di dati di lunghezza sconosciuta.

[in, out] pcbElement

Puntatore a un valore DWORD che specifica le dimensioni, in byte, del buffer a cui punta il parametro pbElement . Quando la funzione viene restituita, il valore DWORD contiene il numero di byte archiviati nel buffer.

Nota Quando si elaborano i dati restituiti nel buffer, le applicazioni devono usare le dimensioni effettive dei dati restituiti. Le dimensioni effettive possono essere leggermente inferiori alle dimensioni del buffer specificato nell'input. In caso di input, le dimensioni del buffer vengono in genere specificate sufficientemente grandi per garantire che i dati di output più grandi possibili si adattino al buffer. Nell'output la variabile a cui punta questo parametro viene aggiornata in modo da riflettere le dimensioni effettive dei dati copiati nel buffer.

Valore restituito

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

Se la funzione ha esito negativo, il valore restituito è FALSE. Per informazioni sugli errori estesi, chiamare GetLastError.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	wincrypt.h
Libreria	Crypt32.lib
DLL	Crypt32.dll

Vedi anche

CertAddSerializedElementToStore

Funzioni per i certificati

Condividi tramite