Rutina MRxQuerySdInfo
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.
Requisitos
Plataforma de destino |
Escritorio |
Encabezado |
Mrx.h (incluya Mrx.h) |