IFileSyncScopeFilter::GetSubDirectoryExcludes

Возвращает коллекцию относительных путей к каталогам, подлежащим исключению из области.

HRESULT GetSubDirectoryExcludes(
  LPWSTR pszSubDirectoryExcludes,
  ULONG *pcchLength);

Параметры

• pszSubDirectoryExcludes
  [in, out, unique, size_is(*pcchLength)] Возвращает список каталогов, которые исключаются из области видимости. Элементы списка разделяются точками с запятой. Если это значение равно пустой строке (""), то каталоги не будут исключаться. Значение по умолчанию — пустая строка ("").

• pcchLength
  [in, out] Указывает длину pszSubDirectoryExcludes в символах. Возвращает количество символов, необходимое для получения списка, если размер pszSubDirectoryExcludes слишком мал, либо возвращает число записанных символов.

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

• S_OK.

• HRESULT_FROM_WIN32(ERROR_MORE_DATA), если размер pszSubDirectoryExcludes слишком мал. В этом случае необходимое количество символов возвращается в pcchLength.

• E_OUTOFMEMORY.

Замечания

В путях к каталогам могут использоваться символы-шаблоны (* и ?).

Исключение каталога означает исключение всех содержащихся в нем файлов и вложенных каталогов.

Пути, содержащиеся в параметре pcszSubDirectoryExcludes, могут быть абсолютными или относительными. Пути должны быть указаны относительно корневого каталога реплики, указанного в методе IFileSyncProvider::Initialize.

См. также

Справочник

Интерфейс IFileSyncScopeFilter