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，或在失敗時傳回下列其中一個錯誤值：

傳回碼 Description
STATUS_INSUFFICIENT_RESOURCES
 資源不足，無法完成此例程。 非分頁集區內存的記憶體配置要求無法儲存新的功能變數名稱。

備註

在網路重新導向器要求開頭可能不知道功能變數名稱。 RxSetSrvCallDomainName 例程允許功能變數名稱在已知後與 SrvCall 產生關聯。 此例程通常用來建立和初始化SRV_CALL結構。

如果功能變數名稱已經與 SrvCall 參數相關聯，則會移除此功能變數名稱，並釋放 SrvCall 中與此專案相關聯的記憶體。

如果 DomainName 參數不是 NULL 指標，且 DomainName 參數的長度大於零，則 RxSetSrvCallDomainName 會從非分頁集區配置 srvCall 的 pDomainName 成員的空間，且集區卷標為 RX_SRVCALL_PARAMS_POOLTAG。 RxSetSrvCallDomainName 例程會設定 pDomainName 結構的緩衝區、長度和 MaximumLength 成員。

規格需求

需求 值
目標平台 桌面
標頭 rxprocs.h (包含 Mrxfcb.h、Rxprocs.h)
IRQL <= APC_LEVEL

另請參閱

RxCreateSrvCall

RxFinalizeSrvCall