Funzione CertSerializeCTLStoreElement (wincrypt.h)

Articolo
08/27/2023

La funzione CertSerializeCTLStoreElement serializza un contesto CTL (Certificate Trust List) codificato e la rappresentazione codificata delle relative proprietà. Il risultato può essere mantenuto nell'archiviazione in modo che le proprietà e CTL possano essere recuperate in un secondo momento.

Sintassi

BOOL CertSerializeCTLStoreElement(
  [in]      PCCTL_CONTEXT pCtlContext,
  [in]      DWORD         dwFlags,
  [out]     BYTE          *pbElement,
  [in, out] DWORD         *pcbElement
);

Parametri

[in] pCtlContext

Puntatore alla struttura CTL_CONTEXT serializzata.

[in] dwFlags

Riservato per l'uso futuro e deve essere zero.

[out] pbElement

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

Questo parametro può essere NULL per impostare le dimensioni di queste informazioni per scopi di allocazione della memoria. Per altre informazioni, vedere Recupero dei 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 restituisce 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 rispetto alle dimensioni del buffer specificato nell'input. In base all'input, le dimensioni del buffer vengono in genere specificate abbastanza grandi per garantire che i dati di output più grandi siano adatti al buffer. Nell'output la variabile a cui punta questo parametro viene aggiornata per 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 sull'errore estese, 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 elenco attendibili certificati

Condividi tramite