IFileSyncScopeFilter::GetFilenameIncludes
Obtém uma coleção de nomes de arquivos a serem incluídos explicitamente no escopo.
HRESULT GetFilenameIncludes(
LPWSTR pszFilenameIncludes,
ULONG *pcchLength);
Parâmetros
- pszFilenameIncludes
[in, out, unique, size_is(*pcchLength)] Retorna a lista delimitada por ponto-e-vírgula dos nomes de arquivos incluídos explicitamente no escopo. Um arquivo que não esteja incluído nesta lista está excluído do escopo. Quando este valor é uma cadeia de caracteres vazia, " ", nenhum arquivo está incluído explicitamente. O valor padrão é "*.*".
- pcchLength
[in, out] Especifica o número de caracteres em pszFilenameIncludes. Retorna o número de caracteres necessários para recuperar a lista quando pszFilenameIncludes é muito pequeno ou retorna o número de caracteres gravados.
Valor de retorno
S_OK.
HRESULT_FROM_WIN32(ERROR_MORE_DATA) quando pszFilenameIncludes é muito pequeno. Nesse caso, o número necessário de caracteres é retornado em pcchLength.
E_OUTOFMEMORY.
Comentários
Podem ser usados curingas (* e ?) nos nomes dos arquivos.
A inclusão explícita é mais fraca que a exclusão. Portanto, se um arquivo ou pasta for excluído por algum outro filtro, ele será excluído do escopo mesmo se estiver explicitamente incluído nesta lista.
Dica
Um arquivo que não esteja incluído em pszFilenameIncludes está excluído do escopo. Por exemplo, se pszFilenameIncludes estiver definido como uma cadeia de caracteres vazia, " ", todos os arquivos estarão excluídos do escopo.