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或失败时返回以下错误值之一:
返回代码 | 说明 |
---|---|
|
资源不足,无法完成此例程。 非分页池内存存储新域名的内存分配请求失败。 |
注解
在网络重定向程序请求开始时,域名可能未知。 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 |