função de retorno de chamada PFN_CRYPT_XML_DATA_PROVIDER_READ (cryptxml.h)

A função de retorno de chamada PFN_CRYPT_XML_DATA_PROVIDER_READ lê dados XML.

Sintaxe

PFN_CRYPT_XML_DATA_PROVIDER_READ PfnCryptXmlDataProviderRead;

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

Parâmetros

[in, out] pvCallbackState

Um ponteiro para um argumento definido pelo aplicativo que é passado para a função de chamada.

[out] pbData

Um ponteiro para o buffer que recebe os dados a serem lidos.

[in] cbData

O tamanho, em bytes, dos dados a serem lidos.

[out] pcbRead

Um ponteiro para uma variável que recebe o número de bytes realmente lidos.

Retornar valor

A função de retorno de chamada PFN_CRYPT_XML_DATA_PROVIDER_READ retorna um valor quando ocorre uma das seguintes condições:

• Uma operação de gravação é concluída no provedor de dados
• O número de bytes solicitados é lido
• Ocorre um erro

Se a função falhar, ela retornará um valor HRESULT que indica o erro.

Se o valor de pcbRead for igual a zero, não haverá mais dados disponíveis.

Comentários

A função de retorno de chamada não retorna um valor, a menos que o número de bytes especificados em cbData esteja disponível ou o último bloco de dados tenha sido lido.

Requisitos