Fonction CertSerializeCTLStoreElement (wincrypt.h)

  • Article

La fonction CertSerializeCTLStoreElement sérialise un contexte de liste d’approbation de certificats encodé (CTL) et la représentation encodée de ses propriétés. Le résultat peut être conservé dans le stockage afin que la durée de vie et les propriétés puissent être récupérées ultérieurement.

Syntaxe

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

Paramètres

[in] pCtlContext

Pointeur vers la structure CTL_CONTEXT sérialisée.

[in] dwFlags

Réservé à une utilisation future et doit être égal à zéro.

[out] pbElement

Pointeur vers une mémoire tampon qui reçoit la sortie sérialisée, y compris la CTL encodée et, éventuellement, ses propriétés.

Ce paramètre peut avoir la valeur NULL pour définir la taille de ces informations à des fins d’allocation de mémoire. Pour plus d’informations, consultez Récupération de données de longueur inconnue.

[in, out] pcbElement

Pointeur vers une valeur DWORD qui spécifie la taille, en octets, de la mémoire tampon pointée par le paramètre pbElement . Lorsque la fonction retourne la valeur DWORD contient le nombre d’octets stockés dans la mémoire tampon.

Note Lors du traitement des données retournées dans la mémoire tampon, les applications doivent utiliser la taille réelle des données retournées. La taille réelle peut être légèrement inférieure à la taille de la mémoire tampon spécifiée lors de l’entrée. (En entrée, les tailles de mémoire tampon sont généralement spécifiées suffisamment grandes pour garantir que les données de sortie les plus volumineuses possibles s’intègrent dans la mémoire tampon.) En sortie, la variable pointée par ce paramètre est mise à jour pour refléter la taille réelle des données copiées dans la mémoire tampon.
 

Valeur retournée

Si la fonction réussit, la valeur de retour est TRUE.

Si la fonction échoue, la valeur de retour est FALSE. Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête wincrypt.h
Bibliothèque Crypt32.lib
DLL Crypt32.dll

Voir aussi

CertAddSerializedElementToStore

Fonctions de liste d’approbation de certificats