Funzione SHIsFileAvailableOffline (shellapi.h)

Articolo
03/02/2024

Determina se un file o una cartella è disponibile per l'uso offline. Questa funzione determina anche se il file verrebbe aperto dalla rete, dalla cache file offline locale o da entrambi i percorsi.

Sintassi

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

Parametri

[in] pwszPath

Tipo: PCWSTR

Puntatore a un valore stringa che specifica il percorso completo di un file o di una directory di rete. Questo percorso non deve essere in formato UNC. Se pszPath non è un percorso di rete, la funzione restituisce E_INVALIDARG.

[out, optional] pdwStatus

Tipo: LPDWORD

Puntatore a una variabile di tipo DWORD che riceve uno o più dei flag seguenti se la funzione ha esito positivo.

OFFLINE_STATUS_LOCAL (0x01)

Se il file è aperto, viene aperto nella cache.

OFFLINE_STATUS_REMOTE (0x02)

Se il file è aperto, è aperto nel server.

OFFLINE_STATUS_INCOMPLETE (0x04)

La copia locale è attualmente incompleta. Il file non può essere aperto in modalità offline fino a quando non è stato sincronizzato.

Valore restituito

Tipo: HRESULT

Questa funzione può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Il file o la directory viene memorizzato nella cache. È disponibile offline a meno che non sia impostato OFFLINE_STATUS_INCOMPLETE.
E_INVALIDARG	Il percorso non è valido o non è un percorso di rete. Il file o la directory non viene memorizzato nella cache.
E_FAIL	Il file o la directory non viene memorizzato nella cache.

Commenti

Se pszPath è una directory, SHIsFileAvailableOffline non restituirà il flag OFFLINE_STATUS_INCOMPLETE .

Se SHIsFileAvailableOffline restituisce sia OFFLINE_STATUS_LOCAL che OFFLINE_STATUS_REMOTE, il file o la directory è aperto in entrambe le posizioni. Ciò è comune quando il server è online.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shellapi.h
Libreria	Shell32.lib
DLL	Shell32.dll (versione 5.0 o successiva)

Condividi tramite