Funzione FsRtlMupGetProviderInfoFromFileObject (ntifs.h)

Articolo
12/21/2024

La routine FsRtlMupGetProviderInfoFromFileObject ottiene informazioni su un redirector di rete registrato con più provider UNC (MUP) da un oggetto file per un file che si trova in un file system remoto.

Sintassi

NTSTATUS FsRtlMupGetProviderInfoFromFileObject(
  [in]      PFILE_OBJECT pFileObject,
  [in]      ULONG        Level,
  [out]     PVOID        pBuffer,
  [in, out] PULONG       pBufferSize
);

Parametri

[in] pFileObject

Puntatore a un oggetto file di un file che si trova in un file system remoto.

[in] Level

Livello di informazioni restituite dalla routine FsRtlMupGetProviderInfoFromFileObject. Per altre informazioni sui valori possibili per questo parametro, vedere la sezione Osservazioni.

[out] pBuffer

Puntatore a un buffer che riceve le informazioni restituite dalla routine FsRtlMupGetProviderInfoFromFileObject . Per altre informazioni sul formato dei dati restituiti in questo buffer, vedere la sezione Osservazioni.

[in, out] pBufferSize

Puntatore a una variabile tipizzata ULONG contenente le dimensioni, in byte, del buffer a cui punta il parametro pBuffer . Se la routine ha esito positivo, questa variabile riceve le dimensioni, in byte, dei dati restituiti nel buffer.

Valore restituito

La routine FsRtlMupGetProviderInfoFromFileObject restituisce uno dei valori NTSTATUS seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	Le informazioni sul reindirizzamento di rete sono state restituite correttamente nel buffer a cui punta il parametro pBuffer .
STATUS_INVALID_PARAMETER	Uno dei parametri è NULL o contiene un valore non valido.
STATUS_OBJECT_NAME_NOT_FOUND	L'oggetto file a cui punta il parametro pFileObject non corrisponde a un oggetto file system remoto completamente aperto.
STATUS_BUFFER_TOO_SMALL	La dimensione del buffer a cui punta il parametro pBuffer è troppo piccola per restituire i dati. In questo caso, la variabile a cui punta il parametro pBufferSize riceve le dimensioni richieste, in byte, del buffer.
STATUS_BUFFER_OVERFLOW	La dimensione del buffer a cui punta il parametro pBuffer è troppo piccola per restituire tutti i dati. Sono stati restituiti solo i dati che si adattano al buffer. In questo caso, la variabile a cui punta il parametro pBufferSize riceve le dimensioni richieste, in byte, del buffer.

Osservazioni

Un driver di filtro del file system può chiamare la routine FsRtlMupGetProviderInfoFromFileObject per ottenere informazioni su un reindirizzamento di rete da un oggetto file per un file che si trova in un file system remoto. La quantità di informazioni restituite dalla routine FsRtlMupGetProviderInfoFromFileObject dipende dal valore del parametro Level . Se il parametro Level è impostato su 1, la routine FsRtlMupGetProviderInfoFromFileObject restituisce una struttura FSRTL_MUP_PROVIDER_INFO_LEVEL_1 nel buffer a cui punta il parametro pBuffer . La struttura FSRTL_MUP_PROVIDER_INFO_LEVEL_1 è definita come segue:

typedef struct _FSRTL_MUP_PROVIDER_INFO_LEVEL_1 {
  ULONG32  ProviderId;
} FSRTL_MUP_PROVIDER_INFO_LEVEL_1, *PFSRTL_MUP_PROVIDER_INFO_LEVEL_1;

Se il parametro Level è impostato su 2, la routine FsRtlMupGetProviderInfoFromFileObject restituisce una struttura FSRTL_MUP_PROVIDER_INFO_LEVEL_2 nel buffer a cui punta il parametro pBuffer . La struttura FSRTL_MUP_PROVIDER_INFO_LEVEL_2 è definita come segue:

typedef struct _FSRTL_MUP_PROVIDER_INFO_LEVEL_2 {
  ULONG32  ProviderId;
  UNICODE_STRING  ProviderName;
} FSRTL_MUP_PROVIDER_INFO_LEVEL_2, *PFSRTL_MUP_PROVIDER_INFO_LEVEL_2;

Un driver di filtro del file system può confrontare rapidamente il valore dell'identificatore del provider con il valore di altri identificatori del provider senza dover eseguire un confronto tra stringhe.

Il valore dell'identificatore del provider UNC per un particolare redirector di rete rimane invariato se il redirector di rete viene scaricato dal sistema e quindi ricaricato nel sistema.

Per ottenere l'identificatore del provider UNC di un redirector di rete dal nome del dispositivo del reindirizzamento di rete, un driver di filtro del file system può chiamare la routine FsRtlMupGetProviderIdFromName.

Fabbisogno

Requisito	Valore
client minimo supportato	La funzione FsRtlMupGetProviderInfoFromFileObject è Windows Vista
piattaforma di destinazione	Universale
intestazione	ntifs.h (include Ntifs.h)
libreria	NtosKrnl.lib
dll	NtosKrnl.exe
IRQL	<= APC_LEVEL

Vedere anche

FsRtlMupGetProviderIdFromName

Condividi tramite