Metodo ITMSPAddress::GetEvent (tapi3.h)

Il metodo GetEvent recupera le informazioni sugli eventi.

Sintassi

HRESULT GetEvent(
  [in, out] DWORD *pdwSize,
            byte  *pEventBuffer
);

Parametri

[in, out] pdwSize

Puntatore a un DWORD che contiene le dimensioni, in byte, di pEventBuffer. In caso di esito positivo, pdwSize restituisce il numero effettivo di byte in pEventBuffer. Se pEventBuffer non è sufficientemente grande, il metodo restituisce TAPI_E_NOTENOUGHMEMORY e questo parametro restituisce il numero, in byte, obbligatorio.

pEventBuffer

[in, out, size_is(*pdwSize)] Puntatore al buffer che contiene informazioni event_info MSP .

Valore restituito

Questo metodo può restituire uno di questi valori.

valore	Significato
S_OK	Il metodo è riuscito.
E_NOTIMPL	Metodo non implementato.
E_POINTER	Il parametro pdwSize o pEventBuffer non è un puntatore valido.
E_OUTOFMEMORY	Memoria insufficiente per eseguire l'operazione.
TAPI_E_NOTENOUGHMEMORY	Il parametro pdwSize non è abbastanza grande per il buffer.
TAPI_E_NOEVENT	Non si è verificato alcun evento.

Commenti

TAPI3 chiama questo metodo quando viene segnalato l'handle di evento specificato in initialize. TAPI chiamerà ripetutamente questo metodo fino a quando non ha esito negativo in modo che possa ottenere più eventi. Ogni chiamata deve restituire una sola struttura di eventi.

Utenti delle classi di base MSP: questo metodo blocca l'elenco di eventi.

Requisiti

Piattaforma di destinazione	Windows
Intestazione	tapi3.h (include Tapi3.h)

Vedi anche

ITMSPAddress

Media Service Provider Interface (MSPI)