PFN_CRYPT_XML_DATA_PROVIDER_READ fonction de rappel (cryptxml.h)

Article
02/26/2024

La fonction de rappel PFN_CRYPT_XML_DATA_PROVIDER_READ lit les données XML.

Syntaxe

PFN_CRYPT_XML_DATA_PROVIDER_READ PfnCryptXmlDataProviderRead;

HRESULT PfnCryptXmlDataProviderRead(
  [in, out] void *pvCallbackState,
  [out]     BYTE *pbData,
  [in]      ULONG cbData,
  [out]     ULONG *pcbRead
)
{...}

Paramètres

[in, out] pvCallbackState

Pointeur vers un argument défini par l’application qui est passé à la fonction appelante.

[out] pbData

Pointeur vers la mémoire tampon qui reçoit les données à lire.

[in] cbData

Taille, en octets, des données à lire.

[out] pcbRead

Pointeur vers une variable qui reçoit le nombre d’octets effectivement lus.

Valeur retournée

La fonction de rappel PFN_CRYPT_XML_DATA_PROVIDER_READ retourne une valeur lorsque l’une des conditions suivantes se produit :

Une opération d’écriture se termine sur le fournisseur de données
Le nombre d’octets demandés est lu
Une erreur se produit

Si la fonction réussit, la fonction retourne NO_ERROR.

Si la fonction échoue, elle retourne une valeur HRESULT qui indique l’erreur.

Si la valeur de pcbRead est égale à zéro, il n’y a plus de données disponibles.

Remarques

La fonction de rappel ne retourne pas de valeur, sauf si le nombre d’octets spécifié dans cbData est disponible ou que le dernier bloc de données a été lu.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	cryptxml.h

Partager via