IOfflineFilesCache::FindItem 메서드(cscobj.h)

캐시에서 특정 파일 또는 디렉터리 항목을 찾습니다.

구문

HRESULT FindItem(
  [in]  LPCWSTR           pszPath,
  [in]  DWORD             dwQueryFlags,
  [out] IOfflineFilesItem **ppItem
);

매개 변수

[in] pszPath

찾을 파일 또는 디렉터리의 UNC 경로입니다.

[in] dwQueryFlags

항목이 캐시에 있을 때 쿼리 작업의 양에 영향을 주는 플래그입니다. 매개 변수에는 다음 비트 플래그 중 하나 이상이 포함될 수 있습니다.

OFFLINEFILES_ITEM_QUERY_REMOTEINFO(0x00000001)

이 플래그는 나중에 사용하도록 예약되어 있습니다.

OFFLINEFILES_ITEM_QUERY_CONNECTIONSTATE(0x00000002)

이 플래그가 설정된 경우 찾기 작업에는 오프라인 파일 저장소에 대한 추가 호출이 포함되어 항목의 연결 상태(온라인/오프라인)에 대한 정보를 가져옵니다. 이 플래그를 설정하지 않으면 작업에 이 추가 작업이 포함되지 않으며 요청 시 요청 시 연결 상태가 쿼리됩니다.

참고 항목에 대한 연결 상태가 필요하다는 것을 알고 있는 경우 이 플래그를 설정하는 것이 약간 더 효율적입니다. 연결 상태가 필요하지 않은 경우 이 플래그를 설정하지 않는 것이 더 효율적입니다.

 

OFFLINEFILES_ITEM_QUERY_LOCALDIRTYBYTECOUNT(0x00000004)

이 플래그가 설정된 경우 찾기 작업에는 오프라인 파일 저장소에 대한 추가 호출이 포함되어 로컬 오프라인 파일 캐시의 연결된 파일에 대한 비동기화("더티") 데이터의 양(바이트)에 대한 정보를 가져옵니다.

OFFLINEFILES_ITEM_QUERY_REMOTEDIRTYBYTECOUNT(0x00000008)

이 플래그는 나중에 사용하도록 예약되어 있습니다.

OFFLINEFILES_ITEM_QUERY_INCLUDETRANSPARENTCACHE(0x00000010)

이 플래그를 설정하면 찾기 작업에 투명하게 캐시된 항목이 포함됩니다.

OFFLINEFILES_ITEM_QUERY_ADMIN(0x80000000)

관리자는 모든 사용자가 캐시한 항목을 찾을 수 있습니다. 이 플래그가 설정되고 호출자가 관리자가 아닌 경우 메서드 호출이 실패합니다.

[out] ppItem

캐시 항목의 IOfflineFilesItem 인터페이스에 대한 포인터입니다.

반환 값

성공하면 S_OK 반환하고, 그렇지 않으면 오류 값을 반환합니다.

캐시 항목을 찾을 수 없는 경우 를 반환 HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) 합니다.

설명

FindItemEx 는 캐시 항목 열거형에서 제공하는 것과 유사한 필터링 기능을 제공하는 FindItem 의 향상된 버전입니다. FindItem을 호출하는 것은 네 개의 필터 매개 변수가 모두 NULL로 설정된 FindItemEx를 호출하는 것과 같습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	cscobj.h
DLL	CscSvc.dll; CscObj.dll

추가 정보

IOfflineFilesCache