Compartir a través de

Función SHIsFileAvailableOffline (shellapi.h)

  • Artículo

Determina si un archivo o carpeta está disponible para su uso sin conexión. Esta función también determina si el archivo se abriría desde la red, desde la caché de archivos sin conexión local o desde ambas ubicaciones.

Sintaxis

SHSTDAPI SHIsFileAvailableOffline(
  [in]            PCWSTR pwszPath,
  [out, optional] DWORD  *pdwStatus
);

Parámetros

[in] pwszPath

Tipo: PCWSTR

Puntero a un valor de cadena que especifica la ruta de acceso completa a un archivo de red o directorio. Esta ruta de acceso no necesita estar en formato UNC. Si pszPath no es una ruta de acceso de red, la función devuelve E_INVALIDARG.

[out, optional] pdwStatus

Tipo: LPDWORD

Puntero a una variable de tipo DWORD que recibe una o varias de las marcas siguientes si la función se realiza correctamente.

OFFLINE_STATUS_LOCAL (0x01)

Si el archivo está abierto, se abre en la memoria caché.

OFFLINE_STATUS_REMOTE (0x02)

Si el archivo está abierto, está abierto en el servidor.

OFFLINE_STATUS_INCOMPLETE (0x04)

La copia local está incompleta actualmente. El archivo no se puede abrir en modo sin conexión hasta que se haya sincronizado.

Valor devuelto

Tipo: HRESULT

Esta función puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 El archivo o directorio se almacena en caché. Está disponible sin conexión a menos que se establezca OFFLINE_STATUS_INCOMPLETE .
E_INVALIDARG
 La ruta de acceso no es válida o no es una ruta de acceso de red. El archivo o directorio no se almacena en caché.
E_FAIL
 El archivo o directorio no se almacena en caché.

Comentarios

Si pszPath es un directorio, SHIsFileAvailableOffline no devolverá la marca OFFLINE_STATUS_INCOMPLETE .

Si SHIsFileAvailableOffline devuelve OFFLINE_STATUS_LOCAL y OFFLINE_STATUS_REMOTE, el archivo o directorio está abierto en ambos lugares. Esto es habitual cuando el servidor está en línea.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shellapi.h
Library Shell32.lib
Archivo DLL Shell32.dll (versión 5.0 o posterior)