código de control de FSCTL_ENUM_EXTERNAL_BACKING

El código de control FSCTL_ENUM_EXTERNAL_BACKING comienza o continúa una enumeración de archivos en un volumen que tiene un origen de respaldo. Para cada finalización correcta de la solicitud, se devuelve un identificador para el archivo respaldado. Todos los archivos respaldados se enumeran independientemente del proveedor externo que lo respalda. Las solicitudes de FSCTL_ENUM_EXTERNAL_BACKING sucesivas son necesarias para enumerar todos los archivos respaldados en el volumen.

Para realizar esta operación, llame a FltFsControlFile o ZwFsControlFile con los parámetros siguientes.

Parámetros

• Instancia [in]: FltFsControlFile solo. Puntero de instancia opaco para el autor de la llamada. Este parámetro es necesario y no se puede null.

• FileObject [in]: FltFsControlFile solo. Objeto de puntero de archivo que especifica el volumen que se va a desmontar. Este parámetro es necesario y no se puede null.

• FileHandle [in]: ZwFsControlFile solo. Identificador de archivo del volumen que se va a desmontar. Este parámetro es necesario y no se puede null.

• FsControlCode [in]: Código de control para la operación. Use FSCTL_ENUM_EXTERNAL_BACKING para esta operación.

• InputBuffer [in]: None. Establezca en null.

• InputBufferLength [in]: Se establece en 0.

• OutputBuffer [out]: puntero al búfer de salida, que debe tener un tamaño lo suficientemente grande como para recibir una o varias estructuras de WOF_EXTERNAL_FILE_ID .

• OutputBufferLength [out]: Tamaño del búfer de salida al que apunta OutputBuffer. OutputBufferLength debe ser >= sizeof(WOF_EXTERNAL_FILE_ID).

• LengthReturned [out]: especifica el número de bytes escritos en OutputBuffer al completarse correctamente.

Bloque de estado

FltFsControlFile o ZwFsControlFile devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, la función adecuada podría devolver uno de los siguientes valores NTSTATUS.

Observaciones

La estructura WOF_EXTERNAL_FILE_ID devuelta en OutputBuffer contiene identificadores de archivo únicos para los archivos respaldados. La estructura se define en ntifs.h como se indica a continuación.

typedef struct _WOF_EXTERNAL_FILE_ID {
    FILE_ID_128 FileId;
} WOF_EXTERNAL_FILE_ID, *PWOF_EXTERNAL_FILE_ID;

Una solicitud de FSCTL_ENUM_EXTERNAL_BACKING se emite sucesivamente para recuperar los identificadores de cada archivo del volumen que tiene origen de respaldo. Cuando se enumeran todos los archivos, se devuelve el código de estado STATUS_NO_MORE_FILES.

Requisitos

Consulte también

fltFsControlFile de

ZwFsControlFile

FSCTL_GET_EXTERNAL_BACKING