Função FltIsVolumeSnapshot (fltkernel.h)

  • Artigo

A rotina FltIsVolumeSnapshot determina se uma instância de driver de volume ou minifiltro está anexada a um volume instantâneo.

Sintaxe

NTSTATUS FLTAPI FltIsVolumeSnapshot(
  [in]  PVOID    FltObject,
  [out] PBOOLEAN IsSnapshotVolume
);

Parâmetros

[in] FltObject

Um ponteiro opaco para o volume ou instância.

[out] IsSnapshotVolume

Um ponteiro para uma variável booliana alocada pelo chamador que recebe TRUE se o volume ou a instância estiver anexado a um volume instantâneo. Caso contrário, a variável receberá FALSE.

Retornar valor

FltIsVolumeSnapshot retorna um dos seguintes valores NTSTATUS:

Código de retorno Descrição
STATUS_SUCCESS
 FltIsVolumeSnapshot determinou se FltObject é um instantâneo.
STATUS_INVALID_PARAMETER
 FltObject especifica algo além de um volume ou uma instância. Este é um código de erro.
STATUS_FLT_NO_DEVICE_OBJECT
 FltObject não tem um objeto de dispositivo de disco associado. Isso pode ocorrer se FltObject estiver associado a uma unidade de rede. Este é um código de erro.
STATUS_INSUFFICIENT_RESOURCES
 FltIsVolumeSnapshot encontrou uma falha de alocação de memória. Este é um código de erro.

Comentários

Se o objeto de instância ou volume não der suporte a instantâneos, FltIsVolumeSnapshot retornará STATUS_SUCCESS e IsSnapshotVolume será FALSE.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows Vista e versões posteriores do Windows.
Plataforma de Destino Universal
Cabeçalho fltkernel.h (inclua Fltkernel.h)
Biblioteca Fltmgr.lib
DLL FltMgr.sys
IRQL PASSIVE_LEVEL