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 分配 pDomainName 成员 SrvCall 的空间,该池的池标记为 RX_SRVCALL_PARAMS_POOLTAG。 RxSetSrvCallDomainName 例程设置 缓冲区长度maximumLengthpDomainName 结构的成员。

要求

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

另请参阅

RxCreateSrvCall

RxFinalizeSrvCall