Rutina MRxQuerySdInfo

Artículo
06/14/2023

RDBSS llama a la rutinaMRxQuerySdInfo para solicitar que una minidirectora de red consulte la información del descriptor de seguridad de consulta en un objeto del sistema de archivos.

Sintaxis

PMRX_CALLDOWN MRxQuerySdInfo;

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

Parámetros

RxContext [in, out]
Puntero a la estructura RX_CONTEXT. Este parámetro contiene el IRP que solicita la operación.

Valor devuelto

MRxQuerySdInfo devuelve STATUS_SUCCESS si se ejecuta correctamente o un valor NTSTATUS adecuado, como uno de los siguientes:

Código devuelto	Descripción
STATUS_ACCESS_DENIED	El autor de la llamada no tiene la seguridad adecuada para esta operación.
STATUS_BUFFER_OVERFLOW	El búfer para recibir la información del descriptor de seguridad era demasiado pequeño. Este valor devuelto debe considerarse correcto y se deben devolver tantos datos válidos como sea posible en el miembro Info.Buffer de la estructura RX_CONTEXT a la que apunta el parámetro RxContext .
STATUS_BUFFER_TOO_SMALL	El búfer es demasiado pequeño para recibir los datos solicitados. Si se devuelve este valor, el miembro InformationToReturn de la estructura RX_CONTEXT a la que apunta el parámetro RxContext debe establecerse en el tamaño mínimo del búfer esperado para que la llamada se realice correctamente.
STATUS_CONNECTION_DISCONNECTED	La conexión se desconectó.
STATUS_INSUFFICIENT_RESOURCES	No había recursos suficientes para completar la consulta.
STATUS_INVALID_PARAMETER	Se especificó un parámetro no válido.
STATUS_NETWORK_ACCESS_DENIED	Se denegó el acceso a la red.
STATUS_NOT_IMPLEMENTED	No se implementa una característica que se solicita, como la información de un archivo de página remoto.
STATUS_NOT_SUPPORTED	La información del descriptor de seguridad no se admite en el recurso compartido remoto.
STATUS_OBJECT_PATH_NOT_FOUND	No se encontró la ruta de acceso del objeto. Este error se puede devolver si se solicitó información sobre un objeto de secuencia NTFS y el sistema de archivos remoto no admite secuencias.
STATUS_REPARSE	Se requiere un análisis para controlar un vínculo simbólico.

Comentarios

RDBSS emite una llamada a MRxQuerySdInfo en respuesta a la recepción de una solicitud de IRP_MJ_QUERY_SECURITY .

Antes de llamar a MRxQuerySdInfo, RDBSS modifica los siguientes miembros de la estructura RX_CONTEXT a la que apunta el parámetro RxContext :

El miembro QuerySecurity.SecurityInformation se establece en IrpSp-Parameters.QuerySecurity.SecurityInformation>.

El miembro Info.Buffer se establece en el búfer de usuario del paquete de solicitud de E/S. Este búfer ya está bloqueado por RDBSS si es necesario.

El miembro Info.LengthRemaining se establece en IrpSp-Parameters.QuerySecurity.Length>.

Si se ejecuta correctamente, el minidirector de red debe establecer el miembro InformationToReturn de la estructura RX_CONTEXT en la longitud de la información de seguridad devuelta. Si la llamada a MRxQuerySdInfo se realizó correctamente, RDBSS establece el miembro IoStatus.Information del IRP en el miembro InformationToReturn de RX_CONTEXT.