IFileSyncScopeFilter::GetFilenameIncludes
Ruft die Auflistung von Dateinamen ab, die explizit in den Bereich eingeschlossen werden sollen.
HRESULT GetFilenameIncludes(
LPWSTR pszFilenameIncludes,
ULONG *pcchLength);
Parameter
- pszFilenameIncludes
[in, out, unique, size_is(*pcchLength)] Gibt die durch Semikolons getrennte Liste von Dateinamen zurück, die explizit in den Bereich eingeschlossen werden. Eine Datei, die nicht in dieser Liste enthalten ist, wird aus dem Bereich ausgeschlossen. Wenn dieser Wert die leere Zeichenfolge " " ist, werden keine Dateien explizit eingeschlossen. Der Standardwert ist "*.*".
- pcchLength
[in, out] Gibt die Anzahl der Zeichen in pszFilenameIncludes an. Gibt die Anzahl der zum Abrufen der Liste erforderlichen Zeichen zurück, wenn pszFilenameIncludes zu klein ist, oder gibt die Anzahl der geschriebenen Zeichen zurück.
Rückgabewert
S_OK.
HRESULT_FROM_WIN32(ERROR_MORE_DATA), wenn pszFilenameIncludes zu klein ist. In diesem Fall wird in pcchLength die erforderliche Anzahl von Zeichen zurückgegeben.
E_OUTOFMEMORY.
Hinweise
In Dateinamen können Platzhalter ("*" und "?") verwendet werden.
Expliziter Einschluss ist schwächer als Ausschluss. Ist eine Datei oder ein Ordner durch einen anderen Filter ausgeschlossen, wird dieses Element aus dem Bereich ausgeschlossen, auch wenn es in dieser Liste explizit eingeschlossen wird.
Hinweis
Eine Datei, die nicht in pszFilenameIncludes enthalten ist, wird aus dem Bereich ausgeschlossen. Wenn beispielsweise pszFilenameIncludes auf die leere Zeichenfolge " " festgelegt ist, werden alle Dateien aus dem Bereich ausgeschlossen.