SDLNet UDP Bind

Aus DGL Wiki
Wechseln zu: Navigation, Suche

SDLNet_UDP_Bind

Name

SDLNet_UDP_Bind - Bindet eine IP-Adresse an einen Channel eines Sockets


Delphi-Spezifikation

function SDLNet_UDP_Bind(sock : PUDPsocket; channel : Integer; var address : TIPaddress) : Integer;


Parameter

sock Der UDPSocket, dem die Adresse zugewiesen werden soll.
channel Der Channel, dem die Adresse zugewiesen werden soll. Dieser Wert sollte kleiner als SDLNET_MAX_UDPCHANNELS sein. Wenn -1 verwendet wird, wird der erste ungebundene Channel verwendet, was nur für das Filtering von eingehenden Paketen verwendet werden sollte, da der erste Channel mit weniger als SDLNET_MAX_UDPADDRESSES zugewiesenen Adressen verwendet wird.
address Die aufgelöste IP-Adresse, die dem Channel des Sockets zugewiesen werden soll. Es werden Host und Port verwendet. Es ist nicht sehr hilfreich einen Channel auf 0.0.0.0 zu binden...


Beschreibung

Bindet eine Adresse an einen Kanal (Channel) eines Sockets.


Eingehende Pakete sind nur von gebundenen Adresse für den Channel des Sockets erlaubt.


Alle ausgehenden Pakete auf diesem Kanal, egal welche Adresse Paketintern angegeben ist, werden an alle gebundenen Adressen des Channels geschickt.


Es können bis zu SDLNET_MAX_UDPADDRESSES pro Channel zugewiesen werden.


Rückgabewert

Es wird die Kanalnummer zurückgegeben die gebunden wurde. -1 wird zurückgegeben, wenn es zu einem Fehler gekommen ist, wenn zum Beispiel keine Kanäle mehr frei waren oder dem übergebene Channel bereits SDLNET_MAX_UDPADDRESSES zugewiesen wurden oder wenn eine Kanalnummer größer oder gleich SDLNET_MAX_UDPCHANNELS oder kleiner als -1 übergeben wurde.


Siehe auch

SDLNet_UDP_Unbind, SDLNet_UDP_GetPeerAddress, SDLNet_UDP_Open, IPaddress, UDPsocket