取得要從範圍中排除之目錄的相對路徑集合。
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 方法中所指定複寫的根目錄。