IFileSyncScopeFilter::GetFilenameIncludes
Ottiene la raccolta di nomi di file da includere nell'ambito in modo esplicito.
HRESULT GetFilenameIncludes(
LPWSTR pszFilenameIncludes,
ULONG *pcchLength);
Parametri
- pszFilenameIncludes
[in, out, size_is(*pcchLength) , unique] Restituisce l'elenco delimitato da punti e virgola dei nomi di file inclusi in modo esplicito nell'ambito. Un file che non è incluso in questo elenco viene escluso dall'ambito. Se questo valore è la stringa vuota " ", non viene incluso alcun file in modo esplicito. Il valore predefinito è "*.*".
- pcchLength
[in, out] Specifica il numero di caratteri in pszFilenameIncludes. Restituisce il numero di caratteri necessari per recuperare l'elenco se pszFilenameIncludes è troppo piccolo oppure restituisce il numero di caratteri scritti.
Valore restituito
S_OK
HRESULT_FROM_WIN32 (ERROR_MORE_DATA) se pszFilenameIncludes è troppo piccolo. In questo caso, il numero di caratteri necessari viene restituito in pcchLength.
E_OUTOFMEMORY
Osservazioni
Nei nomi di file è possibile utilizzare i caratteri jolly * e ?.
Poiché l'inclusione esplicita è più debole rispetto all'esclusione, se un file o una cartella viene esclusa tramite un filtro diverso, sarà esclusa dall'ambito anche se è inclusa in modo esplicito in questo elenco.
Nota
Un file non incluso in pszFilenameIncludes viene escluso dall'ambito. Ad esempio, se pszFilenameIncludes è impostato sulla stringa vuota " ", tutti i file vengono esclusi dall'ambito.