Condividi tramite


Funzione wiasGetContextFromName (wiamdef.h)

La funzione wiasGetContextFromName recupera il contesto dell'elemento per un nome di elemento.

Sintassi

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

Parametri

[in] pWiasContext

Puntatore a un contesto di elemento WIA.

lFlags

Riservato per l'uso del sistema e deve essere impostato su 0.

[in] bstrName

Specifica il nome del contesto da cercare.

[out] ppWiasContext

Puntatore a una posizione di memoria che riceve l'indirizzo del contesto dell'elemento WIA.

Valore restituito

In caso di esito positivo, la funzione restituisce S_OK.

Se la funzione ha esito negativo, restituisce un errore COM standard o uno dei codici di errore wia .

Osservazioni

Questa funzione cerca i contesti di elemento la cui proprietà WIA_IPA_FULL_ITEM_NAME corrisponde bstrName. Si noti che questa proprietà è diversa da WIA_IPA_ITEM_NAME, che non contiene informazioni sul percorso.

Questa funzione deve essere usata dai minidriver quando devono passare da un contesto di elemento dell'applicazione a un altro, dato il nome dell'elemento. I nomi degli elementi dell'applicazione provengono dagli elementi del driver corrispondenti, che il minidriver crea e nomi.

Fabbisogno

Requisito Valore
piattaforma di destinazione Desktop
intestazione wiamdef.h (include Wiamdef.h)
libreria Wiaservc.lib
dll Wiaservc.dll

Vedere anche

wiasGetRootItem