Función FltMupGetProviderInfoFromFileObject (fltkernel.h)

FltMupGetProviderInfoFromFileObject recupera la información del proveedor correspondiente a un objeto de archivo.

Sintaxis

NTSTATUS FLTAPI FltMupGetProviderInfoFromFileObject(
  PFLT_INSTANCE Instance,
  PFILE_OBJECT  FileObject,
  ULONG         Level,
  PVOID         Buffer,
  PULONG        BufferSize
);

Parámetros

Instance

[in] Puntero opaco a la instancia de filtro asociada a este objeto de archivo. Este parámetro es necesario y no puede ser NULL.

FileObject

[in] Puntero al objeto de archivo para el que se va a recuperar la información del proveedor. Este parámetro es necesario y no puede ser NULL.

Level

[in] Nivel de información que debe devolver esta rutina. Para obtener más información sobre los valores posibles para este parámetro, vea FsRtlMupGetProviderInfoFromFileObject.

Buffer

[out] Puntero a un búfer que recibe la información del proveedor. Los datos devueltos se basan en el Level especificado. Este búfer debe ser lo suficientemente grande como para contener la información solicitada por el parámetro Level.

BufferSize

[in/out] Puntero a una variable que especifica el tamaño, en bytes, del búfer al que apunta el parámetro Buffer. En la entrada, esta variable especifica el tamaño del búfer. En la salida, esta variable recibe el número de bytes escritos en el búfer.

Valor devuelto

FltMupGetProviderInfoFromFileObject devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, devuelve un código NTSTATUS adecuado.

Observaciones

Esta rutina es necesaria para controlar el caso de los proveedores que se registran mediante FsRtlRegisterUncProviderEx. El nombre del dispositivo en los objetos de archivo para este proveedor sería \Device\Mup.

Los filtros pueden usar esta rutina para los siguientes fines:

• Para poder filtrar redireccionadores específicos.
• Para buscar un redirector que respalda un objeto de archivo para que puedan solucionar posibles errores en los redireccionadores.

El MUP (proveedor UNC múltiple) no se puede descargar para esta llamada.

El autor de la llamada garantiza que el fileObject de será válido durante la duración de la llamada.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 11, versión 24H2
encabezado de	fltkernel.h
irQL	<= APC_LEVEL

Consulte también

FsRtlMupGetProviderInfoFromFileObject

FsRtlRegisterUncProviderEx