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

  • Artigo

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 for bem-sucedida, a função retornará NO_ERROR.

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

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho cryptxml.h