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 メンバーを設定します。
必要条件
要件 | 価値 |
---|---|
ターゲット プラットフォーム の | デスクトップ |
ヘッダー | rxprocs.h (Mrxfcb.h、Rxprocs.h を含む) |
IRQL | <= APC_LEVEL |
関連項目
RxCreateSrvCall の
RxFinalizeSrvCall の