MRxQuerySdInfo 例程
RDBSS 會呼叫MRxQuerySdInfo 例程,以要求文件系統物件上的網路迷你重新導向器查詢安全性描述元資訊。
語法
PMRX_CALLDOWN MRxQuerySdInfo;
NTSTATUS MRxQuerySdInfo(
_Inout_ PRX_CONTEXT RxContext
)
{ ... }
參數
RxContext [in, out]
RX_CONTEXT 結構的指標。 此參數包含要求作業的 IRP。
傳回值
MRxQuerySdInfo 會在成功或適當的 NTSTATUS 值上傳回STATUS_SUCCESS,例如下列其中一項:
傳回碼 | Description |
---|---|
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 發出 MRxQuerySdInfo 的呼叫,以回應接收 IRP_MJ_QUERY_SECURITY 要求。
呼叫 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) |