GetAddrInfoExCancel-Funktion (ws2tcpip.h)

Die GetAddrInfoExCancel-Funktion bricht einen asynchronen Vorgang durch die GetAddrInfoEx-Funktion ab.

Syntax

INT WSAAPI GetAddrInfoExCancel(
  [in] LPHANDLE lpHandle
);

Parameter

[in] lpHandle

Das Handle des asynchronen Vorgangs, der abgebrochen werden soll. Dies ist das Handle, das im lpNameHandle-Parameter von der GetAddrInfoEx-Funktion zurückgegeben wird.

Rückgabewert

Bei erfolgreicher Ausführung gibt GetAddrInfoExCancelNO_ERROR (0) zurück. Fehler gibt einen fehlerfreien Windows Sockets-Fehlercode zurück, wie in den Windows Sockets-Fehlercodes zu finden.

Hinweise

Die GetAddrInfoExCancel-Funktion bricht einen asynchronen GetAddrInfoEx-Vorgang ab. Das Ergebnis ist, dass der Vervollständigungsmechanismus des Benutzers, entweder ein Rückruf oder ein Ereignis, sofort aufgerufen wird. Es werden keine Ergebnisse zurückgegeben, und der für den asynchronen Vorgang GetAddrInfoEx zurückgegebene Fehlercode ist auf WSA_E_CANCELLED festgelegt. Wenn die GetAddrInfoEx-Anforderung bereits abgeschlossen oder ein Timeout ausgeführt wurde oder das Handle ungültig ist, und WSA_INVALID_HANDLE von der GetAddrInfoExCancel-Funktion zurückgegeben wird.

Da viele der zugrunde liegenden Vorgänge (z. B. Legacynamendienstanbieter) synchron sind, werden diese Vorgänge nicht abgebrochen. Diese Vorgänge werden weiterhin ausgeführt und Ressourcen beansprucht. Sobald die letzte ausstehende Namensdienstanbieteranforderung abgeschlossen ist, werden die Ressourcen freigegeben.

Windows 8.1 und Windows Server 2012 R2: Diese Funktion wird für Windows Store-Apps auf Windows 8.1, Windows Server 2012 R2 und höher unterstützt.

Anforderungen

Weitere Informationen

GetAddrInfoEx