MRxQuerySdInfo ルーチン

[アーティクル]
04/04/2024

TheMRxQuerySdInfo ルーチンは、ネットワークミニリダイレクターがファイルシステムオブジェクトにセキュリティ記述子情報をクエリするように要求するために RDBSS によって呼び出されます。

構文

PMRX_CALLDOWN MRxQuerySdInfo;

NTSTATUS MRxQuerySdInfo(
  _Inout_ PRX_CONTEXT RxContext
)
{ ... }

パラメーター

RxContext [in, out]
RX_CONTEXT 構造体へのポインター。このパラメーターには、操作を要求している IRP が含まれています。

戻り値

MRxQuerySdInfo は、成功した場合に STATUS_SUCCESS を返すか、次のような適切な NTSTATUS 値を返します。

リターンコード	説明
STATUS_ACCESS_DENIED	呼び出し元には、この操作に対する適切なセキュリティが不足しています。
STATUS_BUFFER_OVERFLOW	セキュリティ記述子情報を受け取るバッファーが小さすぎました。この戻り値は成功と見なす必要があり、RxContext パラメーターが指す RX_CONTEXT 構造体の Info.Buffer メンバーにできるだけ有効なデータを返す必要があります。
STATUS_BUFFER_TOO_SMALL	バッファーが小さすぎて、要求されたデータを受信できません。この値が返された場合、RxContext パラメーターによって指される RX_CONTEXT 構造体の InformationToReturn メンバーは、呼び出しが成功するために予想されるバッファーの最小サイズに設定する必要があります。
STATUS_CONNECTION_DISCONNECTED	接続が切断されました。
STATUS_INSUFFICIENT_RESOURCES	クエリを完了するためのリソースが不足していました。
STATUS_INVALID_PARAMETER	無効なパラメーターが指定されました。
STATUS_NETWORK_ACCESS_DENIED	ネットワークアクセスが拒否されました。
STATUS_NOT_IMPLEMENTED	リモートページファイルにファイル情報など、要求される機能は実装されていません。
STATUS_NOT_SUPPORTED	リモート共有では、セキュリティ記述子情報はサポートされていません。
STATUS_OBJECT_PATH_NOT_FOUND	オブジェクトパスが見つからないこのエラーは、NTFS ストリームオブジェクトの情報が要求され、リモートファイルシステムがストリームをサポートしていない場合に返される可能性があります。
STATUS_REPARSE	シンボリックリンクを処理するには、再解析が必要です。

解説

RDBSS は、IRP_MJ_QUERY_SECURITY 要求の受信に応答して MRxQuerySdInfo の呼び出しを発行します。

MRxQuerySdInfo を呼び出す前に、RDBSS は RxContext パラメーターが指す RX_CONTEXT 構造体の次のメンバーを変更します。

QuerySecurity.SecurityInformation メンバーは IrpSp->Parameters.QuerySecurity.SecurityInformation に設定されます。

Info.Buffer メンバーは、I/O 要求パケットからユーザーバッファーに設定されます。このバッファーは、必要に応じて RDBSS によって既にロックされています。

Info.LengthRemaining メンバーは IrpSp->Parameters.QuerySecurity.Length に設定されます。

成功した場合、ネットワークミニリダイレクターは、RX_CONTEXT 構造体の InformationToReturn メンバーを、返されるセキュリティ情報の長さに設定する必要があります。 MRxQuerySdInfo の呼び出しが成功した場合、RDBSS は IRP の IoStatus.Information メンバーを RX_CONTEXT の InformationToReturn メンバーに設定します。

要件

対象プラットフォーム	デスクトップ
ヘッダー	Mrx.h (Mrx.h を含む)

次の方法で共有

MRxQuerySdInfo ルーチン

構文

パラメーター

戻り値

解説

要件

関連項目

フィードバック

フィードバック

その他のリソース