Metodo IWiaDevMgr::RegisterEventCallbackProgram (wia_xp.h)

Il metodo IWiaDevMgr::RegisterEventCallbackProgram registra un'applicazione per ricevere gli eventi del dispositivo. Viene fornito principalmente per la compatibilità con le versioni precedenti con le applicazioni che non sono state scritte per WiA.

Sintassi

HRESULT RegisterEventCallbackProgram(
  [in] LONG       lFlags,
  [in] BSTR       bstrDeviceID,
  [in] const GUID *pEventGUID,
  [in] BSTR       bstrCommandline,
  [in] BSTR       bstrName,
  [in] BSTR       bstrDescription,
  [in] BSTR       bstrIcon
);

Parametri

[in] lFlags

Tipo: LONG

Specifica i flag di registrazione. Può essere impostato sui valori seguenti:

Flag di registrazione	Significato
WIA_REGISTER_EVENT_CALLBACK	Registrarsi per l'evento.
WIA_UNREGISTER_EVENT_CALLBACK	Eliminare la registrazione per l'evento.
WIA_SET_DEFAULT_HANDLER	Impostare l'applicazione come gestore eventi predefinito.

[in] bstrDeviceID

Tipo: BSTR

Specifica un identificatore del dispositivo. Passare NULL per registrarsi per l'evento in tutti i dispositivi WIA.

[in] pEventGUID

Tipo: GUID const*

Specifica l'evento per il quale l'applicazione sta registrando. Per un elenco di GUID di evento validi, vedere Identificatori di evento WIA.

[in] bstrCommandline

Tipo: BSTR

Specifica una stringa contenente il nome completo del percorso e gli argomenti della riga di comando appropriati necessari per richiamare l'applicazione. È necessario usare due coppie di virgolette, ad esempio ""C:\Program Files\MyExe.exe" /arg1".

[in] bstrName

Tipo: BSTR

Specifica il nome dell'applicazione. Questo nome viene visualizzato all'utente quando più applicazioni eseguono la registrazione per lo stesso evento.

[in] bstrDescription

Tipo: BSTR

Specifica la descrizione dell'applicazione. Questa descrizione viene visualizzata all'utente quando più applicazioni eseguono la registrazione per lo stesso evento.

[in] bstrIcon

Tipo: BSTR

Specifica l'icona che rappresenta l'applicazione. L'icona viene visualizzata all'utente quando più applicazioni eseguono la registrazione per lo stesso evento. La stringa contiene il nome dell'applicazione e l'indice in base 0 dell'icona (potrebbero essere presenti più icone che rappresentano l'applicazione) separate da una virgola. Ad esempio, "MyApp, 0".

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Usare IWiaDevMgr::RegisterEventCallbackProgram per registrare gli eventi del dispositivo hardware del tipo WIA_ACTION_EVENT. Quando si verifica un evento per il quale viene registrata un'applicazione, l'applicazione viene avviata e le informazioni sull'evento vengono trasmesse all'applicazione.

Le applicazioni usano il metodo EnumRegisterEventInfo per recuperare un puntatore a un oggetto enumeratore per le proprietà di registrazione degli eventi.

Un'applicazione può determinare se un evento è un tipo di azione o un tipo di notifica (o entrambi) esaminando il valore ulFlags di una struttura WIA_DEV_CAP restituita dall'enumerazione dell'evento.

I programmi devono usare solo il metodo IWiaDevMgr::RegisterEventCallbackProgram per garantire la compatibilità con le versioni precedenti con le applicazioni non scritte per l'architettura WIA. Le nuove applicazioni devono usare le interfacce COM (Component Object Model) fornite dall'architettura WIA. In particolare, devono chiamare IWiaDevMgr::RegisterEventCallbackInterface o IWiaDevMgr::RegisterEventCallbackCLSID per la registrazione per gli eventi del dispositivo.

In genere, questo metodo viene chiamato da un programma di installazione o da uno script. Il programma di installazione o lo script registra l'applicazione per ricevere gli eventi del dispositivo WIA. Quando si verifica l'evento, l'applicazione verrà avviata dal sistema di runtime WIA.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wia_xp.h (include Wia.h)
Libreria	Wiaguid.lib
DLL	Wiaservc.dll