Routine MRxQuerySdInfo

Articolo
02/07/2024

La routineMRxQuerySdInfo viene chiamata da RDBSS per richiedere che un descrittore di sicurezza della query mini-redirector di rete venga descrittore in un oggetto file system.

Sintassi

PMRX_CALLDOWN MRxQuerySdInfo;

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

Parametri

RxContext [in, out]
Puntatore alla struttura RX_CONTEXT. Questo parametro contiene l'IRP che richiede l'operazione.

Valore restituito

MRxQuerySdInfo restituisce STATUS_SUCCESS sull'esito positivo o su un valore NTSTATUS appropriato, ad esempio uno dei seguenti:

Codice restituito	Descrizione
STATUS_ACCESS_DENIED	Il chiamante non ha la sicurezza appropriata per questa operazione.
STATUS_BUFFER_OVERFLOW	Il buffer per ricevere le informazioni del descrittore di sicurezza era troppo piccolo. Questo valore restituito deve essere considerato riuscito e la maggior parte dei dati validi possibile deve essere restituito nel membro Info.Buffer della struttura RX_CONTEXT a cui punta il parametro RxContext .
STATUS_BUFFER_TOO_SMALL	Il buffer è troppo piccolo per ricevere i dati richiesti. Se questo valore viene restituito, il membro InformationToReturn della struttura RX_CONTEXT puntato al parametro RxContext deve essere impostato sulla dimensione minima del buffer previsto per la chiamata.
STATUS_CONNECTION_DISCONNECTED	La connessione è stata disconnessa.
STATUS_INSUFFICIENT_RESOURCES	Per completare la query sono state eseguite risorse insufficienti.
STATUS_INVALID_PARAMETER	È stato specificato un parametro non valido.
STATUS_NETWORK_ACCESS_DENIED	Accesso alla rete negato.
STATUS_NOT_IMPLEMENTED	Non viene implementata una funzionalità richiesta, ad esempio informazioni su un file di pagina remota.
STATUS_NOT_SUPPORTED	Le informazioni del descrittore di sicurezza non sono supportate nella condivisione remota.
STATUS_OBJECT_PATH_NOT_FOUND	Il percorso dell'oggetto non è stato trovato. Questo errore può essere restituito se sono state richieste informazioni su un oggetto di flusso NTFS e il file system remoto non supporta i flussi.
STATUS_REPARSE	Un reparse è necessario per gestire un collegamento simbolico.

Commenti

RDBSS genera una chiamata a MRxQuerySdInfo in risposta alla ricezione di una richiesta di IRP_MJ_QUERY_SECURITY .

Prima di chiamare MRxQuerySdInfo, RDBSS modifica i membri seguenti nella struttura RX_CONTEXT a cui punta il parametro RxContext :

Il membro QuerySecurity.SecurityInformation è impostato su IrpSp-Parameters.QuerySecurity.SecurityInformation>.

Il membro Info.Buffer è impostato sul buffer utente dal pacchetto di richiesta di I/O. Questo buffer è già stato bloccato da RDBSS se necessario.

Il membro Info.LengthRemaining è impostato su IrpSp-Parameters.QuerySecurity.Length>.

In caso di esito positivo, il mini-reindirizzamento di rete deve impostare il membro InformationToReturn della struttura RX_CONTEXT sulla lunghezza delle informazioni di sicurezza restituite. Se la chiamata a MRxQuerySdInfo ha avuto esito positivo, RDBSS imposta il membro IoStatus.Information dell'IRP sul membro InformationToReturn di RX_CONTEXT.