IOfflineFilesCache::P in 메서드(cscobj.h)

아티클
08/22/2023

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

파일이 고정되면 로컬 오프라인 파일 저장소에 캐시됩니다. 자동으로 캐시되는 파일과 달리 고정된 파일은 추가 캐시 공간이 필요할 때 자동 제거로부터 보호됩니다.

구문

HRESULT Pin(
  [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)

일반적으로 셸 링크(LNK 형식)가 고정되면 대상이 자동으로 고정되지 않습니다. 이 플래그가 설정되면 LNK 파일을 고정하면 대상이 파일인 경우 대상이 자동으로 고정됩니다. 대상이 디렉터리인 경우 대상이 자동으로 고정되지 않습니다.

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