Función WofIsExternalFile (wofapi.h)
Se usa para determinar si un archivo está respaldado por un archivo físico o lo está por un proveedor de datos del sistema y, opcionalmente, indica qué proveedor o datos adicionales sobre el archivo.
Sintaxis
HRESULT WofIsExternalFile(
[in] LPCWSTR FilePath,
[out, optional] PBOOL IsExternalFile,
[out, optional] PULONG Provider,
[out, optional] PVOID ExternalFileInfo,
[in, out, optional] PULONG BufferLength
);
Parámetros
[in] FilePath
Especifica la ruta de acceso al archivo para el que se desea el estado de respaldo.
[out, optional] IsExternalFile
Opcionalmente, apunta a un valor BOOL. Si se devuelve correctamente, este valor será TRUE si el objeto está respaldado externamente, FALSE si es un archivo físico.
[out, optional] Provider
Opcionalmente, apunta a un valor de ULONG. Si la devolución es correcta, este valor se establecerá en el proveedor que respalda externamente este objeto. Los proveedores definidos actualmente son:
| WOF_PROVIDER_WIM | Indica que los datos del archivo residen en un archivo WIM independiente. En el acceso, los datos se extraen, descomprimen y proporcionan a las aplicaciones de forma transparente. Si se modifica el contenido del archivo, los datos se descomprimen de forma transparente y el archivo se restaura en un archivo normal. |
| WOF_PROVIDER_FILE | Indica que los datos del archivo deben comprimirse y almacenarse con el propio archivo. En el acceso, los datos se descomprimen de forma transparente y se proporcionan a las aplicaciones. Si se modifica el contenido del archivo, los datos se descomprimen de forma transparente y el archivo se restaura en un archivo normal. Este proveedor requiere Windows 10. |
[out, optional] ExternalFileInfo
Opcionalmente, apunta a un búfer asignado por el autor de la llamada. Si la devolución es correcta, este búfer contendrá información adicional sobre el estado del archivo. Si se proporciona este valor, también se debe especificar BufferLength . Las estructuras de datos de cada proveedor definido son:
| WOF_PROVIDER_WIM | WIM_EXTERNAL_FILE_INFO |
| WOF_PROVIDER_FILE | WOF_FILE_COMPRESSION_INFO |
[in, out, optional] BufferLength
Opcionalmente, apunta a un valor que contiene la longitud del búfer especificado en ExternalFileInfo. En la devolución, este valor se establecerá en el tamaño del búfer consumido o en el tamaño del búfer necesario. Si el búfer tiene una longitud insuficiente, esta función indicará correctamente el tamaño necesario y no rellenará el búfer en ExternalFileInfo. Esta longitud debe corresponder a una de las estructuras definidas anteriormente:
| WOF_PROVIDER_WIM | sizeof(WIM_EXTERNAL_FILE_INFO) |
| WOF_PROVIDER_FILE | sizeof(WOF_FILE_COMPRESSION_INFO) |
Valor devuelto
Esta función devuelve un VALOR HRESULT que indica que se ha realizado correctamente o el motivo del error. Si el búfer especificado en ExternalFileInfo no tiene el tamaño correcto, la función devolverá S_OK e indicará el tamaño de búfer necesario en BufferLength.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | wofapi.h |
| Library | Wofutil.lib |
| Archivo DLL | Wofutil.dll |