SHIsFileAvailableOffline 함수(shellapi.h)

파일 또는 폴더를 오프라인으로 사용할 수 있는지 여부를 결정합니다. 또한 이 함수는 네트워크, 로컬 오프라인 파일 캐시 또는 두 위치에서 파일을 열지 여부를 결정합니다.

구문

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

[in] pwszPath

형식: PCWSTR

네트워크 파일 또는 디렉터리에 대한 전체 경로를 지정하는 문자열 값에 대한 포인터입니다. 이 경로는 UNC 형식일 필요가 없습니다. pszPath가 네트워크 경로가 아닌 경우 함수는 E_INVALIDARG 반환합니다.

[out, optional] pdwStatus

형식: LPDWORD

함수가 성공하면 다음 플래그 중 하나 이상을 수신하는 DWORD 형식의 변수에 대한 포인터입니다.

파일이 열려 있으면 캐시에서 열립니다.

파일이 열려 있으면 서버에서 열립니다.

로컬 복사본이 현재 불완전합니다. 파일이 동기화될 때까지 오프라인 모드로 열 수 없습니다.

형식: HRESULT

이 함수는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드	Description
S_OK	파일 또는 디렉터리가 캐시됩니다. OFFLINE_STATUS_INCOMPLETE 설정되지 않은 한 오프라인에서 사용할 수 있습니다.
E_INVALIDARG	경로가 잘못되었거나 네트워크 경로가 아닙니다. 파일 또는 디렉터리가 캐시되지 않습니다.
E_FAIL	파일 또는 디렉터리가 캐시되지 않습니다.

pszPath가 디렉터리인 경우 SHIsFileAvailableOffline은 OFFLINE_STATUS_INCOMPLETE 플래그를 반환하지 않습니다.

SHIsFileAvailableOffline이 OFFLINE_STATUS_LOCAL 및 OFFLINE_STATUS_REMOTE 모두 반환하는 경우 파일 또는 디렉터리가 두 위치에서 모두 열립니다. 이는 서버가 온라인일 때 일반적입니다.

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	shellapi.h
라이브러리	Shell32.lib
DLL	Shell32.dll(버전 5.0 이상)