Platform SDK: TAPI

ITMSPAddress::GetEvent

Gets event information.

HRESULT GetEvent(
  DWORD *pdwSize,
  byte *pEventBuffer
);

Parameters

pdwSize: [in,out] Pointer to size of buffer containing event information.
pEventBuffer: [in, out, size_is(*pdwSize)] Pointer to buffer containing msp event_info information.

Return Values

Value	Meaning
S_OK	Method succeeded.
E_NOTIMPL	Method not implemented.
E_POINTER	The pdwSize or pEventBuffer parameter is not a valid pointer.
E_OUTOFMEMORY	Insufficient memory exists to perform the operation.
TAPI_E_NOTENOUGHMEMORY	The pdwSize parameter was not large enough for the buffer.
TAPI_E_NOEVENT	No event has occurred.

Remarks

TAPI3 calls this method when the event handle given in initialize is signaled. TAPI will call this method repeatedly until it fails so it can get multiple events. Each call should return only one event structure.

Users of the MSP base classes: This method locks the event list.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Version: Requires TAPI 3.0 or later.
  Header: Declared in Tapi3.h.
  Library: Use T3iid.lib.

ITMSPAddress::GetEvent

Parameters

Return Values

Remarks

Requirements

See Also