Função wiasGetContextFromName (wiamdef.h)
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.
Retornar valor
Em caso de ê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.
Comentários
Essa função pesquisa contextos de item cuja propriedade WIA_IPA_FULL_ITEM_NAME corresponde a 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 eles precisam 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 |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | wiamdef.h (inclua Wiamdef.h) |
| Biblioteca | Wiaservc.lib |
| DLL | Wiaservc.dll |