Funzione FltMupGetProviderInfoFromFileObject (fltkernel.h)

Articolo
10/26/2024

FltMupGetProviderInfoFromFileObject recupera le informazioni sul provider corrispondenti a un oggetto file.

Sintassi

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

Parametri

Instance

[in] Puntatore opaco all'istanza del filtro associata a questo oggetto file. Questo parametro è obbligatorio e non può essere NULL.

FileObject

[in] Puntatore all'oggetto file per il quale devono essere recuperate le informazioni sul provider. Questo parametro è obbligatorio e non può essere NULL.

Level

[in] Livello di informazioni che deve essere restituito da questa routine. Per altre informazioni sui valori possibili per questo parametro, vedere FsRtlMupGetProviderInfoFromFileObject.

Buffer

[out] Puntatore a un buffer che riceve le informazioni sul provider. I dati restituiti si basano sull'livello di specificato. Questo buffer deve essere sufficientemente grande da contenere le informazioni richieste dal parametro Level.

BufferSize

[in/out] Puntatore a una variabile che specifica le dimensioni, in byte, del buffer a cui punta il parametro buffer . In input, questa variabile specifica le dimensioni del buffer. Nell'output, questa variabile riceve il numero di byte scritti nel buffer.

Valore restituito

FltMupGetProviderInfoFromFileObject restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, restituisce un codice NTSTATUS appropriato.

Osservazioni

Questa routine è necessaria per gestire il caso dei provider registrati usando FsRtlRegisterUncProviderEx. Il nome del dispositivo negli oggetti file per tale provider sarà \Device\Mup.

I filtri possono utilizzare questa routine per gli scopi seguenti:

Per essere in grado di filtrare specifici redirector.
Per trovare un redirector che esegue il backup di un oggetto file in modo che possano aggirare i possibili bug nei reindirizzamenti.

Impossibile scaricare MUP (più provider UNC) per questa chiamata.

Il chiamante garantisce che il FileObject sia valido per la durata della chiamata.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 11, versione 24H2
intestazione	fltkernel.h
IRQL	<= APC_LEVEL

Vedere anche

FsRtlMupGetProviderInfoFromFileObject

FsRtlRegisterUncProviderEx

Condividi tramite