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