PartyLocalUdpSocketBindAddressConfiguration

Artikel
02/08/2024

Die Konfiguration, die von der Parteibibliothek zum Binden an einen UDP-Socket verwendet wird.

Syntax

struct PartyLocalUdpSocketBindAddressConfiguration {  
    PartyLocalUdpSocketBindAddressOptions options;  
    uint16_t port;  
}

Mitglieder

options PartyLocalUdpSocketBindAddressOptions

Optionale Flags, die beschreiben, wie diese UDP-Socketkonfiguration interpretiert wird.

port uint16_t

Die spezifische Portnummer, an die der lokale UDP-Socket gebunden wird, wenn party das nächste Mal initialisiert wird.

In der Microsoft Game Core-Version der Partybibliothek bedeutet der Portwert 0, dass die Partybibliothek den bevorzugten lokalen UDP-Multiplayerport von Game Core auswählt, es sei denn, das Optionsflag PartyLocalUdpSocketBindAddressOptions::ExcludeGameCorePreferredUdpMultiplayerPort ist im Optionsfeld angegeben. Bei allen anderen Versionen der Parteibibliothek bedeutet der Portwert 0, dass die Parteibibliothek das System dynamisch einen Port auswählen kann, der auf allen lokalen IP-Adressschnittstellen verfügbar ist.

Wenn dieser Portwert beim Initialisieren der Parteibibliothek nicht gebunden werden kann, gibt PartyManager::Initialize() synchron einen Fehler zurück. Die lesbare Form des Fehlercodes kann über PartyManager::GetErrorMessage() abgerufen werden.

Der Port sollte in nativer Hostbytereihenfolge angegeben werden. Wenn Ihre Anwendung auch direkt ihre eigenen Socket-API-Aufrufe verwendet oder portiert, beachten Sie, dass sich diese natürliche Bytereihenfolge daher von der Netzwerkbytereihenfolge unterscheiden kann, die von den Portnummern der Socketadresse verwendet wird.

Der Standardwert ist 0, wenn PartyOption::LocalUdpSocketBindAddress nicht konfiguriert wurde.

Hinweise

Diese Struktur kann zusammen mit PartyOption::LocalUdpSocketBindAddress verwendet werden, um die aktuelle Konfiguration der Parteibibliothek über PartyManager::SetOption() bzw . PartyManager::GetOption() zu überschreiben oder abzufragen.

Voraussetzungen

Header: Party.h

Weitere Informationen

Party-Mitglieder
PartyOption::LocalUdpSocketBindAddress
PartyLocalUdpSocketBindAddressOptions
PartyManager::SetOption
PartyManager::GetOption

Freigeben über