FindNextVolumeMountPointA-Funktion (winbase.h)
Setzt eine bereitgestellte Ordnersuche fort, die von einem Aufruf der funktion FindFirstVolumeMountPoint gestartet wurde. FindNextVolumeMountPoint findet einen bereitgestellten Ordner pro Aufruf.
Syntax
BOOL FindNextVolumeMountPointA(
[in] HANDLE hFindVolumeMountPoint,
[out] LPSTR lpszVolumeMountPoint,
[in] DWORD cchBufferLength
);
Parameter
[in] hFindVolumeMountPoint
Ein bereitgestellter Ordnersuchhandle, der von einem vorherigen Aufruf der FindFirstVolumeMountPoint--Funktion zurückgegeben wird.
[out] lpszVolumeMountPoint
Ein Zeiger auf einen Puffer, der den Namen des bereitgestellten Ordners empfängt, der gefunden wird.
[in] cchBufferLength
Die Länge des Puffers, der den Namen des bereitgestellten Ordners empfängt, in TCHARs.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten. Wenn keine weiteren bereitgestellten Ordner gefunden werden können, gibt die GetLastError--Funktion den ERROR_NO_MORE_FILES Fehlercode zurück. Schließen Sie in diesem Fall die Suche mit der funktion FindVolumeMountPointClose.
Bemerkungen
Nachdem das Suchhandle durch Aufrufen FindFirstVolumeMountPoint-eingerichtet wurde, können Sie die FindNextVolumeMountPoint--Funktion verwenden, um nach anderen bereitgestellten Ordnern zu suchen.
Die FindFirstVolumeMountPoint, FindNextVolumeMountPoint-und FindVolumeMountPointClose- Funktionen geben Pfade zu bereitgestellten Ordnern für ein angegebenes Volume zurück. Sie geben keine Laufwerkbuchstaben oder Volume-GUID-Pfade zurück. Informationen zum Aufzählen des Volumes GUID- Pfaden für ein Volume finden Sie unter Enumerating Volume GUID Paths.
Sie sollten keine Korrelation zwischen der Reihenfolge der bereitgestellten Ordner annehmen, die mit diesen Funktionen zurückgegeben werden, und der Reihenfolge der bereitgestellten Ordner, die von anderen Funktionen oder Tools zurückgegeben werden.
In Windows 8 und Windows Server 2012 wird diese Funktion von den folgenden Technologien unterstützt.
| Technologie | Abgestützt |
|---|---|
| Server Message Block (SMB) 3.0-Protokoll | Nein |
| SMB 3.0 Transparent Failover (TFO) | Nein |
| SMB 3.0 mit Skalierungsdateifreigaben (SO) | Nein |
| Freigegebenes Clustervolumedateisystem (CsvFS) | Nein |
| Resilient File System (ReFS) | Nein |
SMB unterstützt keine Volumeverwaltungsfunktionen. CsvFS unterstützt das Hinzufügen von Bereitstellungspunkt auf einem CSV-Volume nicht. ReFS indexiert keine Bereitstellungspunkte.
Anmerkung
Der winbase.h-Header definiert FindNextVolumeMountPoint als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows XP [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | winbase.h (enthalten Windows.h) |
| Library | Kernel32.lib |
| DLL- | Kernel32.dll |