FltMupGetProviderInfoFromFileObject 函式 （fltkernel.h）

FltMupGetProviderInfoFromFileObject 擷取對應至檔案物件的提供者資訊。

語法

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

參數

Instance

[in]與這個檔案對象相關聯之篩選實例的不透明指標。 這是必要參數，而且不能是 NULL。

FileObject

[in]要擷取提供者資訊之檔案物件的指標。 這是必要參數，而且不能是 NULL。

Level

[in]這個例程應該傳回的信息層級。 如需此參數可能值的詳細資訊，請參閱 FsRtlMupGetProviderInfoFromFileObject。

Buffer

[out]接收提供者信息的緩衝區指標。 傳回的數據是以指定的 層級為基礎。 此緩衝區必須夠大，才能保存 Level 參數所要求的資訊。

BufferSize

[in/out]變數的指標，指定 Buffer 參數所指向之緩衝區的大小，以位元組為單位。 在輸入時，此變數會指定緩衝區的大小。 在輸出中，此變數會接收寫入緩衝區的位元元組數目。

傳回值

如果作業成功，FltMupGetProviderInfoFromFileObject 會傳回STATUS_SUCCESS。 否則，它會傳回適當的NTSTATUS程式代碼。

言論

需要此例程來處理使用 FsRtlRegisterUncProviderEx註冊的提供者案例。 這類提供者檔案物件上的裝置名稱會 \Device\Mup。

篩選條件可以使用此例程進行下列用途：

• 若要能夠篩選特定的重新導向器。
• 若要尋找備份檔案物件的重新導向器，以便解決重新導向器中可能的錯誤。

無法卸除此呼叫的 MUP （多個 UNC 提供者）。

呼叫者保證 FileObject 在呼叫期間有效。

要求

另請參閱

FsRtlMupGetProviderInfoFromFileObject

FsRtlRegisterUncProviderEx