Função wiasGetContextFromName (wiamdef.h)

Artigo
02/07/2025

A função wiasGetContextFromName recupera o contexto do item para um nome de item.

Sintaxe

HRESULT wiasGetContextFromName(
  [in]  BYTE *pWiasContext,
        LONG lFlags,
  [in]  BSTR bstrName,
  [out] BYTE **ppWiasContext
);

Parâmetros

[in] pWiasContext

Ponteiro para um contexto de item WIA.

lFlags

Reservado para uso do sistema e deve ser definido como 0.

[in] bstrName

Especifica o nome do contexto que está sendo pesquisado.

[out] ppWiasContext

Ponteiro para um local de memória que recebe o endereço do contexto do item WIA.

Valor de retorno

Com êxito, a função retorna S_OK.

Se a função falhar, ela retornará um erro COM padrão ou um dos códigos de erro wia .

Observações

Essa função pesquisa contextos de item cuja propriedade WIA_IPA_FULL_ITEM_NAME corresponde bstrName. Observe que essa propriedade é diferente de WIA_IPA_ITEM_NAME, que não contém informações de caminho.

Essa função deve ser usada por minidrivers quando precisarem passar de um contexto de item de aplicativo para outro, dado o nome do item. Os nomes dos itens de aplicativo vêm de seus itens de driver correspondentes, que o minidriver cria e nomeia.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	wiamdef.h (inclua Wiamdef.h)
biblioteca	Wiaservc.lib
de DLL	Wiaservc.dll

Consulte também

wiasGetRootItem

Compartilhar via