ITMSPAddress::GetEvent-Methode (msp.h)
Die GetEvent-Methode ruft Ereignisinformationen ab.
Syntax
HRESULT GetEvent(
[in, out] DWORD *pdwSize,
byte *pEventBuffer
);
Parameter
[in, out] pdwSize
Ein Zeiger auf ein DWORD, das die Größe von pEventBuffer in Bytes enthält. Bei Erfolg gibt pdwSize die tatsächliche Anzahl von Bytes in pEventBuffer zurück. Wenn pEventBuffer nicht groß genug ist, gibt die Methode TAPI_E_NOTENOUGHMEMORY zurück, und dieser Parameter gibt die erforderliche Zahl in Bytes zurück.
pEventBuffer
[in, out, size_is(*pdwSize)] Ein Zeiger auf den Puffer, der MSP-event_info Informationen enthält.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Wert | Bedeutung |
|---|---|
|
Methode war erfolgreich. |
|
Methode nicht implementiert. |
|
Der pdwSize - oder pEventBuffer-Parameter ist kein gültiger Zeiger. |
|
Zum Ausführen des Vorgangs ist nicht genügend Arbeitsspeicher vorhanden. |
|
Der pdwSize-Parameter war nicht groß genug für den Puffer. |
|
Es ist kein Ereignis aufgetreten. |
Hinweise
TAPI3 ruft diese Methode auf, wenn das in initialize angegebene Ereignishandle signalisiert wird. TAPI ruft diese Methode wiederholt auf, bis ein Fehler auftritt, sodass mehrere Ereignisse abgerufen werden können. Jeder Aufruf sollte nur eine Ereignisstruktur zurückgeben.
Benutzer der MSP-Basisklassen: Diese Methode sperrt die Ereignisliste.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | msp.h (einschließlich Tapi3.h) |