PFN_CRYPT_XML_DATA_PROVIDER_READ Rückruffunktion (cryptxml.h)

Die rückruffunktion PFN_CRYPT_XML_DATA_PROVIDER_READ liest XML-Daten.

Syntax

PFN_CRYPT_XML_DATA_PROVIDER_READ PfnCryptXmlDataProviderRead;

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

Parameter

[in, out] pvCallbackState

Ein Zeiger auf ein anwendungsdefiniertes Argument, das an die aufrufende Funktion übergeben wird.

[out] pbData

Ein Zeiger auf den Puffer, der die zu lesenden Daten empfängt.

[in] cbData

Die Größe der zu lesenden Daten in Bytes.

[out] pcbRead

Ein Zeiger auf eine Variable, die die Anzahl der tatsächlich gelesenen Bytes empfängt.

Rückgabewert

Die PFN_CRYPT_XML_DATA_PROVIDER_READ Rückruffunktion gibt einen Wert zurück, wenn eine der folgenden Bedingungen auftritt:

  • Ein Schreibvorgang wird für den Datenanbieter abgeschlossen.
  • Die Anzahl der angeforderten Bytes wird gelesen.
  • Fehler
Wenn die Funktion erfolgreich ist, gibt die Funktion NO_ERROR zurück.

Wenn die Funktion fehlschlägt, wird ein HRESULT-Wert zurückgegeben, der den Fehler angibt.

Wenn der Wert von pcbRead gleich null ist, sind keine weiteren Daten verfügbar.

Hinweise

Die Rückruffunktion gibt keinen Wert zurück, es sei denn, die in cbData angegebene Anzahl von Bytes ist verfügbar oder der letzte Datenblock wurde gelesen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile cryptxml.h