função de retorno de chamada PFN_MAPPINGCALLBACKPROC (elscore.h)

Artigo
02/26/2024

Uma função de retorno de chamada definida pelo aplicativo que processa de forma assíncrona os dados produzidos pela função MappingRecognizeText . O tipo MAPPINGCALLBACKPROC define um ponteiro para essa função de retorno de chamada. MappingCallbackProc é um espaço reservado para o nome da função definida pelo aplicativo.

Sintaxe

PFN_MAPPINGCALLBACKPROC PfnMappingcallbackproc;

void PfnMappingcallbackproc(
  [in] _MAPPING_PROPERTY_BAG *pBag,
  [in] LPVOID data,
  [in] DWORD dwDataSize,
  [in] HRESULT Result
)
{...}

Parâmetros

[in] pBag

Ponteiro para uma estrutura MAPPING_PROPERTY_BAG que contém os resultados da chamada para MappingRecognizeText.

[in] data

Ponteiro para dados de aplicativos privados. Esse ponteiro é o mesmo que foi passado no membro pRecognizeCallerData da estrutura MAPPING_OPTIONS .

[in] dwDataSize

Tamanho, em bytes, dos dados do aplicativo privado. Esse tamanho é o mesmo que passado no membro dwRecognizeCallerDataSize da estrutura MAPPING_OPTIONS quando o aplicativo chama MappingRecognizeText de forma assíncrona.

[in] Result

Retornar código de MappingRecognizeText. O código de retorno será S_OK se a função tiver sido bem-sucedida ou um código de erro, caso contrário.

Retornar valor

Nenhum

Comentários

Uma função MappingCallbackProc consome os resultados recuperados por MappingRecognizeText. O aplicativo registra a função de retorno de chamada passando seu endereço para MappingRecognizeText em uma estrutura MAPPING_OPTIONS .

O aplicativo deve marcar o parâmetro Result antes de usar os dados no parâmetro pBag. Quando terminar de usar os dados do recipiente de propriedades, o aplicativo deverá chamar MappingFreePropertyBag porque o recipiente de propriedades pode conter ponteiros para o texto original. Para obter mais informações sobre o recipiente de propriedades, consulte as observações para a estrutura MAPPING_PROPERTY_BAG .

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	elscore.h