IFileSyncScopeFilter::GetSubDirectoryExcludes
Obtém a coleção de caminhos relativos de diretórios a serem excluídos do escopo.
HRESULT GetSubDirectoryExcludes(
LPWSTR pszSubDirectoryExcludes,
ULONG *pcchLength);
Parâmetros
- pszSubDirectoryExcludes
[in, out, unique, size_is(*pcchLength)] Retorna a lista delimitada por ponto-e-vírgula dos diretórios excluídos do escopo. Quando este valor é uma cadeia de caracteres vazia, " ", nenhum diretório é excluído. O valor padrão é a cadeia de caracteres vazia, " ".
- pcchLength
[in, out] Especifica o número de caracteres em pszSubDirectoryExcludes. Retorna o número de caracteres necessários para recuperar a lista quando pszSubDirectoryExcludes é muito pequeno ou retorna o número de caracteres gravados.
Valor de retorno
S_OK.
HRESULT_FROM_WIN32(ERROR_MORE_DATA) quando pszSubDirectoryExcludes for 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 diretórios.
A exclusão de um diretório exclui todos os arquivos e subdiretórios contidos naquele diretório.
Os caminhos contidos em pcszSubDirectoryExcludes podem ser absolutos ou relativos. Caminhos relativos são relativos ao diretório raiz da réplica, como especificado no método IFileSyncProvider::Initialize.