Metodo IWiaItem::EnumRegisterEventInfo (wia_xp.h)

Il metodo IWiaItem::EnumRegisterEventInfo crea un enumeratore usato per ottenere informazioni sugli eventi per cui viene registrata un'applicazione.

Sintassi

HRESULT EnumRegisterEventInfo(
  [in]  LONG              lFlags,
  [in]  const GUID        *pEventGUID,
  [out] IEnumWIA_DEV_CAPS **ppIEnum
);

Parametri

[in] lFlags

Tipo: LONG

Attualmente inutilizzato. Deve essere impostato su zero.

[in] pEventGUID

Tipo: GUID const*

Puntatore a un identificatore che specifica l'evento hardware per il quale si desiderano informazioni di registrazione.

[out] ppIEnum

Tipo: IEnumWIA_DEV_CAPS**

Riceve l'indirizzo di un puntatore all'interfaccia IEnumWIA_DEV_CAPS .

Valore restituito

Tipo: HRESULT

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

Commenti

Un'applicazione richiama questo metodo per creare un oggetto enumeratore per le informazioni sull'evento. IWiaItem::EnumRegisterEventInfo archivia l'indirizzo dell'interfaccia IEnumWIA_DEV_CAPS dell'oggetto enumeratore nel parametro ppIEnum . Il programma usa quindi il puntatore dell'interfaccia per enumerare le proprietà dell'evento per cui è registrato.

Ogni struttura WIA_DEV_CAP include un'indicazione del fatto che l'evento sia di tipo WIA_NOTIFICATION_EVENT o WIA_ACTION_EVENT o entrambi.

Le applicazioni devono chiamare il metodo IUnknown::Release nei puntatori di interfaccia ricevuti tramite il parametro ppIEnum .

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 (includere Wia.h)
Libreria	Wiaguid.lib
DLL	Wiaservc.dll