funzione wiasGetContextFromName (wiamdef.h)

La funzione wiasGetContextFromName recupera il contesto dell'elemento per un nome 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.

Commenti

Questa funzione cerca contesti di elemento la cui proprietà WIA_IPA_FULL_ITEM_NAME corrisponde a 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 dell'elemento dell'applicazione a un'altra, in base al nome dell'elemento. I nomi degli elementi dell'applicazione provengono dagli elementi del driver corrispondenti, che il minidriver crea e nomi.

Requisiti

Vedi anche

wiasGetRootItem