IFileSyncScopeFilter::GetFilenameIncludes
Obtiene la colección de nombres de archivo que se deben incluir explícitamente en el ámbito.
HRESULT GetFilenameIncludes(
LPWSTR pszFilenameIncludes,
ULONG *pcchLength);
Parámetros
- pszFilenameIncludes
[in, out, unique, size_is(*pcchLength)] Devuelve la lista de nombres de archivo delimitados por punto y coma que se incluyen explícitamente en el ámbito. Los archivos que no están incluidos en esta lista se excluyen del ámbito. Cuando este valor es la cadena vacía " ", no se incluye ningún archivo explícitamente. El valor predeterminado es "*.*".
- pcchLength
[in, out] Especifica el número de caracteres de pszFilenameIncludes. Devuelve el número de caracteres necesarios para recuperar la lista si pszFilenameIncludes es demasiado pequeño, o bien, el número de caracteres escritos.
Valor devuelto
S_OK
HRESULT_FROM_WIN32(ERROR_MORE_DATA) si pszFilenameIncludes es demasiado pequeño. En este caso, el número necesario de caracteres se devuelve en pcchLength.
E_OUTOFMEMORY
Notas
Se pueden usar caracteres comodín (? y *) en los nombres de archivo.
La inclusión explícita es más débil que la exclusión. Por consiguiente, si un archivo o carpeta se excluye mediante algún otro filtro, se excluirá del ámbito aun cuando esté incluido explícitamente en esta lista.
Nota
Los archivos que no están incluidos en pszFilenameIncludes se excluyen del ámbito. Por ejemplo, si pszFilenameIncludes se establece en la cadena vacía " ", todos los archivos se excluyen del ámbito.