Função FltMupGetProviderInfoFromFileObject (fltkernel.h)

FltMupGetProviderInfoFromFileObject recupera as informações do provedor correspondentes a um objeto de arquivo.

Sintaxe

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

Parâmetros

Instance

[in] Ponteiro opaco para a instância de filtro associada a este objeto de arquivo. Esse parâmetro é necessário e não pode ser NULL.

FileObject

[in] Ponteiro para o objeto de arquivo para o qual as informações do provedor devem ser recuperadas. Esse parâmetro é necessário e não pode ser NULL.

Level

[in] O nível de informações que essa rotina deve retornar. Para obter mais informações sobre os valores possíveis para esse parâmetro, consulte FsRtlMupGetProviderInfoFromFileObject.

Buffer

[out] Ponteiro para um buffer que recebe as informações do provedor. Os dados retornados são baseados node Nível de especificado. Esse buffer deve ser grande o suficiente para conter as informações solicitadas pelo parâmetro Level.

BufferSize

[entrada/saída] Ponteiro para uma variável que especifica o tamanho, em bytes, do buffer que é apontado pelo parâmetro do buffer . Na entrada, essa variável especifica o tamanho do buffer. Na saída, essa variável recebe o número de bytes que foram gravados no buffer.

Valor de retorno

FltMupGetProviderInfoFromFileObject retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, ele retornará um código NTSTATUS apropriado.

Observações

Essa rotina é necessária para lidar com o caso de provedores que se registram usando FsRtlRegisterUncProviderEx. O nome do dispositivo nos objetos de arquivo para esse provedor seria \Device\Mup.

Os filtros podem usar essa rotina para as seguintes finalidades:

• Para poder filtrar redirecionadores específicos.
• Para encontrar um redirecionador que faça backup de um objeto de arquivo para que ele possa contornar possíveis bugs em redirecionadores.

O MUP (vários provedores UNC) não pode ser descarregado para essa chamada.

O chamador garante que o FileObject será válido durante a chamada.

Requisitos

Consulte também

FsRtlMupGetProviderInfoFromFileObject

FsRtlRegisterUncProviderEx