SDLNet UDP Bind
Inhaltsverzeichnis
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-Addresse, 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