SIO_WSK_SET_REMOTE_ADDRESS

Der SIO_WSK_SET_REMOTE_ADDRESS Socket-E/A-Steuerungsvorgang ermöglicht es einer WSK-Anwendung, eine feste Remotetransportadresse für einen Datagrammsocket anzugeben. Dieser Socket-E/A-Steuerungsvorgang gilt nur für Datagrammsockets.

Wenn eine WSK-Anwendung eine feste Remotetransportadresse für einen Datagrammsocket festlegt, werden alle Datagramme, die über den Socket gesendet werden, an die feste Remotetransportadresse gesendet, und nur Datagramme, die von der festen Remotetransportadresse empfangen werden, werden akzeptiert.

Eine WSK-Anwendung kann eine feste Remotetransportadresse überschreiben, wenn sie ein Datagramm über den Socket sendet, indem sie beim Aufrufen der WskSendTo-Funktion eine alternative Remotetransportadresse im RemoteAddress-Parameter angibt. In dieser Situation wird das Datagramm an die alternative Remotetransportadresse anstelle der festen Remotetransportadresse gesendet. Antworten, die von einer alternativen Remotetransportadresse zurückgesendet werden, werden jedoch nicht akzeptiert.

Wenn eine WSK-Anwendung diesen Socket-E/A-Steuerungsvorgang verwendet, um eine feste Remotetransportadresse anzugeben, muss dies erfolgen, nachdem der Datagrammsocket an eine lokale Transportadresse gebunden wurde.

Um eine feste Remotetransportadresse für einen Datagrammsockets festzulegen, ruft eine WSK-Anwendung die WskControlSocket-Funktion mit den folgenden Parametern auf.

Parameter	Wert
Requesttype	WskIoctl
ControlCode	SIO_WSK_SET_REMOTE_ADDRESS
Level	0
InputSize	Die Größe der SOCKADDR-Struktur, auf die der InputBuffer-Parameter verweist.
Inputbuffer	Ein Zeiger auf eine Struktur, die eine feste Remotetransportadresse für den Datagrammsocket angibt. Der Zeiger muss ein Zeiger auf den spezifischen SOCKADDR-Strukturtyp sein, der der Adressfamilie entspricht, die die WSK-Anwendung beim Erstellen des Datagrammsockets angegeben hat.
OutputSize	0
OutputBuffer	NULL
OutputSizeReturned	NULL

Um eine feste Remotetransportadresse für einen Datagrammsockets zu löschen, ruft eine WSK-Anwendung die WskControlSocket-Funktion mit den folgenden Parametern auf.

Parameter	Wert
Requesttype	WskIoctl
ControlCode	SIO_WSK_SET_REMOTE_ADDRESS
Level	0
InputSize	0
Inputbuffer	NULL
OutputSize	0
OutputBuffer	NULL
OutputSizeReturned	NULL

Eine WSK-Anwendung muss beim Aufrufen der WskControlSocket-Funktion einen Zeiger auf einen IRP angeben, um eine feste Remotetransportadresse für einen Datagrammsocket festzulegen oder zu löschen.

Requirements (Anforderungen)

Version	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Header	Wsk.h (einschließen von Wsk.h)