Функция CfSetInSyncState (cfapi.h)

Задает синхронизированное состояние для файла-заполнителя или папки.

Синтаксис

HRESULT CfSetInSyncState(
  [in]                HANDLE               FileHandle,
  [in]                CF_IN_SYNC_STATE     InSyncState,
  [in]                CF_SET_IN_SYNC_FLAGS InSyncFlags,
  [in, out, optional] USN                  *InSyncUsn
);

Параметры

[in] FileHandle

Дескриптор заполнителя. Платформа правильно синхронизирует операцию с другими активными запросами. Достаточно атрибута или дескриптора без доступа. Вызывающий объект должен иметь WRITE_DATA или WRITE_DAC доступ к заполнителю.

[in] InSyncState

Синхронизированное состояние. InSyncState можно задать одно из следующих значений:

• Если указано CF_IN_SYNC_STATE_NOT_IN_SYNC , платформа очищает синхронизированное состояние заполнителя после успешного возврата из вызова API.
• Если указан CF_IN_SYNC_STATE_IN_SYNC , платформа устанавливает синхронизированное состояние заполнителя при успешном возвращении из вызова API.

[in] InSyncFlags

Флаги состояния синхронизации. Дополнительные сведения см. в CF_SET_IN_SYNC_FLAGS .

[in, out, optional] InSyncUsn

Если этот параметр указан, inSyncUsn указывает платформе выполнять синхронизированные параметры только в том случае, если файл по-прежнему имеет то же значение USN, что и переданный. Это необходимо, чтобы закрыть гонку, в которой поставщик синхронизации просто синхронизирует изменения заполнителей в облаке, но до вызова CfSetInSyncState заполнитель каким-то образом изменился. Передача указателя на значение USN для входных 0 данных аналогична передаче указателя NULL . При возврате InSYncUsn получает окончательное значение USN после установки синхронизированного состояния.

Возвращаемое значение

Если эта функция завершается успешно, она возвращает .S_OK В противном случае возвращается код ошибки HRESULT .

Требования

См. также раздел

CF_IN_SYNC_STATE

CF_SET_IN_SYNC_FLAGS