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

오프라인 파일 캐시에서 파일, 디렉터리 및 네트워크 공유 폴더를 고정 해제합니다. 고정은 Windows 사용자 인터페이스에서 "Always Available Offline"이라고 합니다.

파일이 고정 해제되면 더 이상 오프라인에서 사용할 수 있도록 보장되지 않습니다. 고정 해제 작업이 폴더 리디렉션, 그룹 정책 또는 사용자에 의해 고정되지 않고 해당 항목에 동기화되지 않은 오프라인 변경 내용이 없다는 측면에서 핀 정보의 모든 인스턴스를 제거하는 경우 언제든지 캐시에서 자동으로 제거될 수 있습니다.

구문

HRESULT Unpin(
  [in] HWND                      hwndParent,
  [in] LPCWSTR                   *rgpszPaths,
  [in] ULONG                     cPaths,
  [in] BOOL                      bDeep,
  [in] BOOL                      bAsync,
  [in] DWORD                     dwPinControlFlags,
  [in] IOfflineFilesSyncProgress *pIProgress
);

매개 변수

[in] hwndParent

표시되는 모든 사용자 인터페이스 요소에 대한 부모 창을 식별합니다. OFFLINEFILES_PIN_CONTROL_FLAG_INTERACTIVE 플래그가 dwPinControlFlags 매개 변수에 설정되지 않은 경우 이 매개 변수는 무시됩니다.

[in] rgpszPaths

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

[in] cPaths

rgpszPaths 배열의 경로 수입니다.

[in] bDeep

제공된 경로 중 하나 이상이 디렉터리 또는 공유 폴더를 참조하는 경우 이 인수는 모든 하위 디렉터리를 고정 해제할지 여부를 나타냅니다. 이 매개 변수가 TRUE이면 모든 하위 디렉터리가 재귀적으로 고정 해제됩니다. 이 매개 변수가 FALSE이면 디렉터리의 바로 자식인 파일만 고정 해제됩니다.

[in] bAsync

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

[in] dwPinControlFlags

고정 해제 작업의 동작을 제어합니다. 다음 플래그 중 하나 이상이 될 수 있습니다.

OFFLINEFILES_PIN_CONTROL_FLAG_FILL(0x00000001)

고정 해제 시 무시됩니다.

OFFLINEFILES_PIN_CONTROL_PINLINKTARGETS(0x00000010)

고정 해제 시 무시됩니다.

OFFLINEFILES_PIN_CONTROL_FLAG_FORUSER(0x00000020)

호출 사용자에 대한 항목을 고정 해제합니다. 일반적으로 이 함수의 호출자에 대해 설정된 플래그입니다. 오프라인 파일은 고정의 진정한 사용자별 개념을 지원하지 않는다는 점에 유의해야 합니다. 항목이 사용자에 대해 고정되면 해당 컴퓨터의 모든 사용자에 대해 고정됩니다. 그러나 고정된 파일에 액세스하는 기능은 온라인 상태에서 계산된 파일에 대한 사용자의 액세스 권한에 따라 달라집니다.

OFFLINEFILES_PIN_CONTROL_FLAG_FORUSER_POLICY(0x00000040)

사용자별 정책에 대한 항목을 고정 해제합니다. 이는 오프라인 파일 사용자 인터페이스를 통해 사용자가 이 플래그를 수정할 수 없다는 점에서 "FORUSER" 플래그와 다릅니다. 내부적으로 오프라인 파일은 항목이 그룹 정책 확장에 의해 고정 해제된 경우 이 플래그를 설정합니다.

OFFLINEFILES_PIN_CONTROL_FLAG_FORALL(0x00000080)

로컬 컴퓨터의 모든 사용자에 대한 항목을 고정 해제합니다. 고정된 상태는 모든 사용자에게 적용되지만 고정된 파일에 액세스하는 기능은 온라인 상태에서 계산된 해당 파일에 대한 사용자의 액세스 권한에 따라 달라집니다.

OFFLINEFILES_PIN_CONTROL_FLAG_FORREDIR(0x00000100)

호출하는 사용자에 대한 폴더 리디렉션을 위해 항목을 고정 해제합니다. Windows 폴더 리디렉션은 리디렉션된 폴더를 고정 해제할 때 이 플래그를 설정합니다.

OFFLINEFILES_PIN_CONTROL_FLAG_LOWPRIORITY(0x00000200)

다음에 사용하도록 예약됩니다.

OFFLINEFILES_PIN_CONTROL_FLAG_ASYNCPROGRESS(0x00000400)

진행률이 실제 작업과 함께 진행률 인터페이스에 비동기적으로 보고됩니다. 동작에 대한 자세한 내용은 비동기 진행률 알림 섹션을 참조하세요. 이 플래그를 설정하지 않으면 진행률이 각 작업과 동기적으로 보고됩니다.

OFFLINEFILES_PIN_CONTROL_FLAG_INTERACTIVE(0x00000800)

작업에서 필요에 따라 사용자 인터페이스 요소를 표시할 수 있는 경우 이 플래그를 설정합니다. 예를 들어 시스템의 자격 증명 요청 대화 상자가 있습니다. 이 플래그를 설정하면 hwndParent 의 값이 표시되는 모든 사용자 인터페이스 요소의 부모로 사용됩니다.

OFFLINEFILES_PIN_CONTROL_FLAG_CONSOLE(0x00001000)

"대화형" 플래그가 설정되지 않은 경우 이 플래그는 무시됩니다. "대화형" 플래그가 설정된 경우 이 플래그는 생성된 모든 UI가 작업을 호출하는 프로세스와 연결된 콘솔 창으로 이동되어야 했음을 나타냅니다.

OFFLINEFILES_PIN_CONTROL_FLAG_BACKGROUND(0x00010000)

응용 프로그램이 핀 작업에 대해 현재 열려 있는 파일을 열려는 경우 고정 해제 작업이 위반을 공유하지 않도록 하려면 이 플래그를 설정합니다. 이 시나리오가 발생하고 이 플래그가 설정되면 고정 해제 작업은 "백오프"되며 해당 시간에 특정 파일에 대해 완료되지 않습니다. 이 플래그는 주로 오프라인 파일 서비스에서 내부 작업에 사용됩니다.

[in] pIProgress

작업 중에 진행률 이벤트를 수신할 이벤트 싱크에 대한 인터페이스입니다. 이벤트가 필요 없는 경우 이 매개 변수는 NULL일 수 있습니다.

반환 값

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

작업이 취소되면 를 반환 HRESULT_FROM_WIN32(ERROR_CANCELLED) 합니다.

설명

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

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

진행률 이벤트 인터페이스	메서드	설명
IOfflineFilesProgress	시작	작업을 시작할 때 호출합니다.
IOfflineFilesSyncProgress	SyncItemBegin	각 파일에 대한 처리를 시작할 때 호출됩니다.
IOfflineFilesSyncProgress	SyncItemResult	각 파일이 고정 해제된 후 호출됩니다.
IOfflineFilesProgress	QueryAbort	취소 요청을 검색하기 위해 동기화 작업 중에 주기적으로 호출됩니다.
IOfflineFilesProgress	End	작업이 끝날 때 호출합니다.

요구 사항

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

추가 정보

IOfflineFilesCache