RxSetSrvCallDomainName 函数 (rxprocs.h)

  • 项目

RxSetSrvCallDomainName 由网络微型重定向程序驱动程序调用，以设置与任何给定服务器关联的域名 (SRV_CALL 结构) 。

语法

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

参数

[in] SrvCall

指向 SRV_CALL 结构的指针。

[in] DomainName

指向缓冲区的指针，该缓冲区包含以零结尾的 Unicode 字符串，该字符串命名此服务器所属的域。

返回值

RxSetSrvCallDomainName 在成功时返回STATUS_SUCCESS或失败时返回以下错误值之一：

返回代码 说明
STATUS_INSUFFICIENT_RESOURCES
 资源不足，无法完成此例程。 非分页池内存存储新域名的内存分配请求失败。

注解

在网络重定向程序请求开始时，域名可能未知。 RxSetSrvCallDomainName 例程允许域名在知道后与 SrvCall 相关联。 此例程通常用作创建和初始化SRV_CALL结构的一部分。

如果某个域名已与 SrvCall 参数关联，则将删除此域名，并且将释放与 SrvCall 中此条目关联的内存。

如果 DomainName 参数不是 NULL 指针，并且 DomainName 参数的长度大于零，则 RxSetSrvCallDomainName 将从池标记为 RX_SRVCALL_PARAMS_POOLTAG 的非分页池中为 SrvCall 的 pDomainName 成员分配空间。 RxSetSrvCallDomainName 例程设置 pDomainName 结构的 buffer、length 和 MaximumLength 成员。

要求

要求 值
目标平台 桌面
标头 rxprocs.h (包括 Mrxfcb.h、Rxprocs.h)
IRQL <= APC_LEVEL

另请参阅

RxCreateSrvCall

RxFinalizeSrvCall