获取要从作用域中排除的目录的相对路径集合。
HRESULT GetSubDirectoryExcludes(
LPWSTR pszSubDirectoryExcludes,
ULONG *pcchLength);
参数
- pszSubDirectoryExcludes
[in, out, unique, size_is(*pcchLength)] 返回从作用域中排除的目录的分号分隔的列表。如果此值为空字符串 " ",则不会排除任何目录。默认值为空字符串 " "。
- pcchLength
[in, out] 指定 pszSubDirectoryExcludes 中的字符数。如果 pszSubDirectoryExcludes 太小,则返回检索列表所需的字符数;否则返回写入的字符数。
返回值
S_OK。
如果 pszSubDirectoryExcludes 太小,则返回值为 HRESULT_FROM_WIN32(ERROR_MORE_DATA)。在这种情况下,则在 pcchLength 中返回必需的字符数。
E_OUTOFMEMORY。
备注
在目录路径中可以使用通配符(* 和 ?)。
排除某个目录将排除该目录中包含的所有文件和子目录。
pcszSubDirectoryExcludes 中包含的路径可以是绝对路径,也可以是相对路径。相对路径是相对于在 IFileSyncProvider::Initialize 方法中指定副本的根目录的路径。