StorageLibraryChangeReader.GetLastChangeId Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene un valor único que representa el último cambio procesado por el servicio de indexación para storageFolder o StorageLibrary especificados.
public:
virtual unsigned long long GetLastChangeId() = GetLastChangeId;uint64_t GetLastChangeId();public ulong GetLastChangeId();function getLastChangeId()Public Function GetLastChangeId () As ULongDevoluciones
Identificador de cambio válido (> 0) si se han producido cambios.
Devuelve 0 si aún no se han producido cambios desde la última vez que se leen o no se han producido cambios.
Devuelve StorageLibraryChangeId::Unknown si el rastreador de cambios no puede calcular el identificador de cambio o se han producido demasiados cambios de archivo y este valor se desborda.
Requisitos de Windows
| Familia de dispositivos |
Windows 10, version 2104 (se introdujo en la versión 10.0.20348.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (se introdujo en la versión v12.0)
|
Ejemplos
// 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();
}
}
}