IOfflineFilesCache::D eleteItems 메서드(cscobj.h)

로컬 캐시에서 파일 및 디렉터리를 삭제합니다. 컨테이너 항목을 삭제하면 포함된 모든 항목이 재귀적으로 삭제됩니다.

구문

HRESULT DeleteItems(
  [in] LPCWSTR                     *rgpszPaths,
  [in] ULONG                       cPaths,
  [in] DWORD                       dwFlags,
  [in] BOOL                        bAsync,
  [in] IOfflineFilesSimpleProgress *pIProgress
);

매개 변수

[in] rgpszPaths

삭제할 파일 또는 디렉터리의 정규화된 UNC 경로에 대한 포인터의 배열입니다.

[in] cPaths

rgpszPaths 배열의 경로 수입니다.

[in] dwFlags

삭제 작업의 동작을 제어하는 플래그입니다. 이 매개 변수는 다음 값 중 하나 이상일 수 있습니다.

OFFLINEFILES_DELETE_FLAG_NOAUTOCACHED(0x00000001)

자동으로 캐시된 항목을 삭제하지 마세요. 기본 동작은 자동으로 캐시된 항목을 삭제하는 것입니다.

OFFLINEFILES_DELETE_FLAG_NOPINNED(0x00000002)

고정된 항목은 삭제하지 마세요. 기본 동작은 고정된 항목을 삭제하는 것입니다.

OFFLINEFILES_DELETE_FLAG_DELMODIFIED(0x00000004)

캐시에서 로컬로 수정된 경우에도 삭제합니다. 기본 동작은 동기화되지 않은 로컬 변경 내용이 있는 파일을 삭제하지 않는 것입니다.

OFFLINEFILES_DELETE_FLAG_ADMIN(0x80000000)

관리자는 액세스 권한에 관계없이 모든 파일을 열거하고 삭제할 수 있습니다. 이 플래그가 설정되고 호출자가 관리자가 아닌 경우 함수가 실패합니다.

[in] bAsync

작업이 비동기적으로 수행될 것인지를 나타냅니다. 이 매개 변수가 TRUE이면 작업이 비동기 작업으로 예약되고 함수가 즉시 반환됩니다. 이 매개 변수가 FALSE이면 작업이 완료되면 함수가 반환됩니다.

[in] pIProgress

작업 중에 진행률 이벤트를 수신하는 이벤트 싱크에 대한 인터페이스입니다. 이벤트를 원하지 않는 경우 이 매개 변수는 NULL일 수 있습니다. 비동기 작업에는 이벤트 싱크를 제공하는 것이 좋습니다. 진행률 구현은 비동기 작업이 완료될 때 알림을 받을 수 있는 유일한 방법입니다.

반환 값

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

작업이 취소된 경우 를 반환 HRESULT_FROM_WIN32(ERROR_CANCELLED) 합니다. 작업 중에 오류가 발생한 경우 HRESULT_FROM_WIN32(ERROR_MORE_DATA)를 반환합니다. IOfflineFilesSimpleProgress::ItemResult 콜백 메서드를 사용하여 오류가 발생할 때 검색합니다.

설명

호출자는 삭제할 파일 및 디렉터리에 대한 충분한 액세스 권한이 있어야 합니다.

진행 중인 동안 삭제 작업이 취소되면 해당 지점으로 처리된 파일의 변경 내용은 롤백되지 않습니다.

디렉터리에 대한 삭제 작업이 포함된 파일 또는 디렉터리를 모두 제거할 수 없는 경우(예: 액세스가 거부된 경우) 지정된 디렉터리 항목이 제거되지 않습니다. 해당 시점까지 삭제된 모든 파일 및 디렉터리도 삭제된 상태로 유지됩니다.

파일은 로컬 캐시에서만 삭제됩니다. 네트워크 서버의 연결된 파일은 영향을 받지 않습니다.

삭제된 파일은 휴지통을 통해 복구할 수 없습니다. 오프라인에서 사용할 수 있도록 삭제된 파일을 다시 캐시해야 합니다.

rgpszPaths 매개 변수에 하나의 경로만 제공되고 해당 경로가 단일 파일에 있는 경우 반환 값은 해당 단일 삭제 작업의 결과를 나타냅니다. 그렇지 않으면 호출자는 다음 목록에서 진행률 콜백 메서드를 구현하고 IOfflineFilesSimpleProgress::ItemResult 메서드를 모니터링하여 처리된 각 파일 및 디렉터리에 대한 결과를 가져와야 합니다.

진행률 이벤트 인터페이스	메서드	Description
IOfflineFilesProgress	시작	작업을 시작할 때 호출됩니다.
IOfflineFilesSimpleProgress	ItemBegin	각 파일에 대한 처리를 시작할 때 호출됩니다.
IOfflineFilesSimpleProgress	ItemResult	각 파일이 삭제된 후 호출됩니다.
IOfflineFilesProgress	QueryAbort	동기화 작업 중에 주기적으로 호출되어 취소 요청을 검색합니다.
IOfflineFilesProgress	End	작업이 끝날 때 호출됩니다.

요구 사항

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

추가 정보

IOfflineFilesCache