Поделиться через


IFileSyncScopeFilter::GetFilenameExcludes

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

HRESULT GetFilenameExcludes(
  LPWSTR pszFilenameExcludes,
  ULONG *pcchLength);

Параметры

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

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

  • S_OK.

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

  • E_OUTOFMEMORY.

Замечания

В именах файлов можно применять шаблоны (* и ?).

Вычисление имен файлов в параметре pszFilenameExcludes производится с помощью функции PathMatchSpec. Каталоги в списке исключения не вычисляются.

См. также

Справочник

Интерфейс IFileSyncScopeFilter