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會從非分頁集區配置SrvCallpDomainName成員的空間,且集區標籤為 RX_SRVCALL_PARAMS_POOLTAG。 RxSetSrvCallDomainName常式會設定pDomainName結構的緩衝區長度MaximumLength成員。

規格需求

   
目標平臺 桌面
標頭 rxprocs.h (包括 Mrxfcb.h、Rxprocs.h)
IRQL <= APC_LEVEL

另請參閱

RxCreateSrvCall

RxFinalizeSrvCall