SIO_WSK_SET_REMOTE_ADDRESS

Операция управления SIO_WSK_SET_REMOTE_ADDRESS сокета ввода-вывода позволяет приложению WSK указать фиксированный удаленный адрес транспорта для сокета диаграммы данных. Эта операция управления ввода-вывода сокета применяется только к сокетам диаграммы данных.

Если приложение WSK задает фиксированный адрес удаленного транспорта для сокета диаграммы данных, все диаграммы данных, отправляемые по сокету, отправляются на фиксированный удаленный транспортный адрес, и принимаются только диаграммы данных, полученные из фиксированного адреса удаленного транспорта.

Приложение WSK может переопределить фиксированный удаленный адрес транспорта при отправке диаграммы данных через сокет, указав альтернативный удаленный адрес транспорта в параметре RemoteAddress при вызове функции WskSendTo. В этой ситуации диаграмма данных отправляется на альтернативный адрес удаленного транспорта вместо фиксированного адреса удаленного транспорта. Однако любые ответы, отправляемые обратно из альтернативного адреса удаленного транспорта, не будут приняты.

Если приложение WSK использует эту операцию управления ввода-вывода сокета для указания фиксированного адреса удаленного транспорта, оно должно сделать это после привязки сокета диаграммы данных к локальному адресу транспорта.

Чтобы задать фиксированный удаленный адрес транспорта для сокета диаграммы данных, приложение WSK вызывает функцию WskControlSocket со следующими параметрами.

Параметр	Ценность
RequestType	WskIoctl
ControlCode	SIO_WSK_SET_REMOTE_ADDRESS
уровня	0
InputSize	Размер структуры SOCKADDR, на которую указывает параметр InputBuffer.
InputBuffer	Указатель на структуру, указывающую фиксированный адрес удаленного транспорта для сокета диаграммы данных. Указатель должен быть указателем на конкретный тип структуры SOCKADDR, соответствующий семейству адресов, указанному приложением WSK при создании сокета диаграммы данных.
OutputSize	0
OutputBuffer	НЕДЕЙСТВИТЕЛЬНЫЙ
OutputSizeReturned	НЕДЕЙСТВИТЕЛЬНЫЙ

Чтобы очистить фиксированный удаленный адрес транспорта для сокета диаграммы данных, приложение WSK вызывает функцию WskControlSocket со следующими параметрами.

Параметр	Ценность
RequestType	WskIoctl
ControlCode	SIO_WSK_SET_REMOTE_ADDRESS
уровня	0
InputSize	0
InputBuffer	НЕДЕЙСТВИТЕЛЬНЫЙ
OutputSize	0
OutputBuffer	НЕДЕЙСТВИТЕЛЬНЫЙ
OutputSizeReturned	НЕДЕЙСТВИТЕЛЬНЫЙ

Приложение WSK должно указать указатель на IRP при вызове функции WskControlSocket, чтобы задать или очистить фиксированный адрес удаленного транспорта для сокета диаграммы данных.

Требования

Версия	Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Заголовок	Wsk.h (include Wsk.h)