IOfflineFilesCache::FindItemEx 메서드(cscobj.h)
캐시에서 특정 파일 또는 디렉터리 항목을 찾습니다.
구문
HRESULT FindItemEx(
[in] LPCWSTR pszPath,
[in] IOfflineFilesItemFilter *pIncludeFileFilter,
[in] IOfflineFilesItemFilter *pIncludeDirFilter,
[in] IOfflineFilesItemFilter *pExcludeFileFilter,
[in] IOfflineFilesItemFilter *pExcludeDirFilter,
[in] DWORD dwQueryFlags,
[out] IOfflineFilesItem **ppItem
);
매개 변수
[in] pszPath
찾을 파일 또는 디렉터리의 UNC 경로입니다.
[in] pIncludeFileFilter
제공된 경우 파일을 포함하도록 결정에 적용된 필터를 참조합니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다.
[in] pIncludeDirFilter
제공된 경우 디렉터리를 포함하는 결정에 적용된 필터를 참조합니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다.
[in] pExcludeFileFilter
제공된 경우 파일 제외 결정에 적용된 필터를 참조합니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다.
[in] pExcludeDirFilter
제공된 경우 디렉터리를 제외하는 결정에 적용된 "필터"를 참조합니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다.
[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 |
추가 정보
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기