IFileSyncScopeFilter::GetFilenameIncludes
범위에 명시적으로 포함할 파일 이름 컬렉션을 가져옵니다.
HRESULT GetFilenameIncludes(
LPWSTR pszFilenameIncludes,
ULONG *pcchLength);
매개 변수
- pszFilenameIncludes
[in, out, unique, size_is(*pcchLength)] 범위에 명시적으로 포함되는 파일 이름을 세미콜론으로 구분한 목록을 반환합니다. 이 목록에 포함되지 않은 파일은 범위에서 제외됩니다. 이 값이 빈 문자열(" ")이면 아무런 파일도 명시적으로 포함되지 않습니다. 기본값은 "*.*"입니다.
- pcchLength
[in, out] pszFilenameIncludes의 문자 수를 지정합니다. pszFilenameIncludes가 너무 작으면 목록을 검색하는 데 필요한 문자 수를 반환하고, 그렇지 않으면 쓴 문자 수를 반환합니다.
반환 값
S_OK
pszFilenameIncludes가 너무 작으면 HRESULT_FROM_WIN32(ERROR_MORE_DATA)입니다. 이 경우에는 pcchLength에서 필요한 문자 수가 반환됩니다.
E_OUTOFMEMORY
주의
와일드카드(* 및 ?)를 파일 이름에 사용할 수 있습니다.
명시적 포함은 제외보다 약합니다. 따라서 파일 또는 폴더를 다른 필터로 제외할 경우 해당 항목이 이 목록에 명시적으로 포함되어도 해당 범위에서 제외됩니다.
참고
pszFilenameIncludes에 포함되지 않은 파일은 범위에서 제외됩니다. 예를 들어 pszFilenameIncludes가 빈 문자열(" ")로 설정되면 모든 파일이 범위에서 제외됩니다.