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
このサーバーが属するドメインに名前を付ける、0 で終わる Unicode 文字列を含むバッファーへのポインター。
戻り値
RxSetSrvCallDomainName は、成功した場合はSTATUS_SUCCESS、失敗した場合は次のいずれかのエラー値を返します。
リターン コード | 説明 |
---|---|
|
このルーチンを完了するためのリソースが不足していました。 新しいドメイン名を格納する非ページ プール メモリのメモリ割り当て要求が失敗しました。 |
注釈
ネットワーク リダイレクター要求の開始時に、ドメイン名が不明な場合があります。 RxSetSrvCallDomainName ルーチンを使用すると、認識されると、ドメイン名を SrvCall に関連付けることができます。 通常、このルーチンは、SRV_CALL構造体の作成と初期化の一部として使用されます。
ドメイン名が 既に SrvCall パラメーターに関連付けられている場合、このドメイン名は削除され、 SrvCall のこのエントリに関連付けられているメモリは解放されます。
DomainName パラメーターが NULL ポインターではなく、DomainName パラメーターの長さが 0 より大きい場合、RxSetSrvCallDomainName は、RX_SRVCALL_PARAMS_POOLTAGのプール タグを持つ非ページ プールから SrvCall の pDomainName メンバーの領域を割り当てます。 RxSetSrvCallDomainName ルーチンは、pDomainName 構造体のバッファー、長さ、および MaximumLength メンバーを設定します。
要件
要件 | 値 |
---|---|
対象プラットフォーム | デスクトップ |
Header | rxprocs.h (Mrxfcb.h、Rxprocs.h を含む) |
IRQL | <= APC_LEVEL |