StorageLibraryChangeReader.GetLastChangeId 메서드

정의

네임스페이스:

Windows.Storage

지정된 StorageFolder 또는 StorageLibrary에 대한 인덱싱 서비스에서 처리한 마지막 변경 사항을 나타내는 고유 값을 가져옵니다.

public:
 virtual unsigned long long GetLastChangeId() = GetLastChangeId;

uint64_t GetLastChangeId();

public ulong GetLastChangeId();

function getLastChangeId()

Public Function GetLastChangeId () As ULong

반환

UInt64

unsigned long long

uint64_t

변경 내용이 있는 경우 유효한 변경 ID(> 0)입니다.

마지막으로 읽은 이후 변경 내용이 없거나 아직 변경되지 않은 경우 0을 반환합니다.

변경 추적기가 변경 ID를 계산할 수 없거나 너무 많은 파일 변경이 발생하고 이 값이 오버플로되는 경우 StorageLibraryChangeId::Unknown을 반환합니다.

Windows 요구 사항

디바이스 패밀리	Windows 10, version 2104 (10.0.20348.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v12.0에서 도입되었습니다.)

예제

// applications are expected to persist the previous value
UINT64 appsLastPersistedChangeId = StorageLibraryLastChangeId::Unknown();
StorageFolder folder = StorageFolder::GetFolderFromPathAsync(L"my folder path").get();

StorageLibraryChangeTracker tracker = folder.TryGetChangeTracker();
if (tracker != nullptr)
{
StorageLibraryChangeTrackerOptions ops;
ops.TrackChangeDetails(false);
tracker.Enable(ops);

StorageLibraryChangeReader reader = tracker.GetChangeReader();
if (reader != nullptr)
{
    UINT32 changeId = reader.GetLastChangeId();
    if ((changeId == StorageLibraryLastChangeId::Unknown())
    {
        ScanFolderSlow();
    }
    else if (changeId == 0)
    {
        // no changes in the storage folder yet, OR nothing has changed
        ProcessNormalApplicationStartup();
    }
    else if (changeId != appsLastPersistedChangeId)
    {
        // There have been new changes since we’ve last ran, process them
        appsLastPersistedChangeId = changeId;
        ScanFolderForChanges();
    }
    else
    {
        // changeId and our last persisted change id match, also normal application startup
        ProcessNormalApplicationStartup();
    }
}
}

추가 정보

• StorageLibraryChangeReader
• StorageLibraryLastChangeId