Функция RxSetSrvCallDomainName (rxprocs.h)

Статья
02/26/2024

RxSetSrvCallDomainName вызывается драйвером сетевого мини-перенаправления, чтобы задать доменное имя, связанное с любым заданным сервером (SRV_CALL структуре).

Синтаксис

NTSTATUS RxSetSrvCallDomainName(
  [in] IN PMRX_SRV_CALL   SrvCall,
  [in] IN PUNICODE_STRING DomainName
);

Параметры

[in] SrvCall

Указатель на структуру SRV_CALL.

[in] DomainName

Указатель на буфер, содержащий строку Юникода, завершающуюся с нуля, которая называет домен, к которому принадлежит этот сервер.

Возвращаемое значение

RxSetSrvCallDomainName возвращает STATUS_SUCCESS при успешном выполнении или одно из следующих значений ошибки при сбое:

Код возврата	Описание
STATUS_INSUFFICIENT_RESOURCES	Недостаточно ресурсов для выполнения этой процедуры. Не удалось выполнить запрос на выделение памяти для памяти непагрегированного пула для хранения нового доменного имени.

Доменное имя может быть неизвестно в начале запроса перенаправителя сети. Подпрограмма RxSetSrvCallDomainName позволяет связать доменное имя с SrvCall после его получения. Обычно эта подпрограмма используется в процессе создания и инициализации структуры SRV_CALL.

Если доменное имя уже связано с параметром SrvCall , это доменное имя будет удалено, а память, связанная с этой записью в SrvCall , будет освобождена.

Если параметр DomainName не является указателем NULL и параметр DomainName имеет длину больше нуля, то RxSetSrvCallDomainName выделяет место для элемента pDomainNameSrvCall из непагированного пула с тегом пула RX_SRVCALL_PARAMS_POOLTAG. Подпрограмма RxSetSrvCallDomainName задает буфер, длину и элементы MaximumLength структуры pDomainName .

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	rxprocs.h (включая Mrxfcb.h, Rxprocs.h)
IRQL	<= APC_LEVEL

См. также раздел

RxCreateSrvCall

RxFinalizeSrvCall

Share via