FindNextVolumeMountPointA-Funktion (winbase.h)
Setzt eine eingebundene Ordnersuche fort, die durch einen Aufruf der FindFirstVolumeMountPoint-Funktion gestartet wurde. FindNextVolumeMountPoint findet einen eingebundenen Ordner pro Aufruf.
Syntax
BOOL FindNextVolumeMountPointA(
[in] HANDLE hFindVolumeMountPoint,
[out] LPSTR lpszVolumeMountPoint,
[in] DWORD cchBufferLength
);
Parameter
[in] hFindVolumeMountPoint
Ein bereitgestelltes Ordnersuchhandle, das von einem vorherigen Aufruf der FindFirstVolumeMountPoint-Funktion zurückgegeben wurde.
[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 eingebundenen Ordnernamen in TCHARs empfängt.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. Wenn keine eingebundenen Ordner mehr 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 .
Hinweise
Nachdem das Suchhandle durch Aufrufen von FindFirstVolumeMountPoint eingerichtet wurde, können Sie die FindNextVolumeMountPoint-Funktion verwenden, um nach anderen eingebundenen Ordnern zu suchen.
Die Funktionen FindFirstVolumeMountPoint, FindNextVolumeMountPoint und FindVolumeMountPointClose geben Pfade zu eingebundenen Ordnern für ein angegebenes Volume zurück. Sie geben keine Laufwerkbuchstaben oder Volume-GUID-Pfade zurück. Informationen zum Aufzählen der Volume-GUID-Pfade für ein Volume finden Sie unter Auflisten von Volume-GUID-Pfaden.
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.
Unter Windows 8 und Windows Server 2012 wird diese Funktion von den folgenden Technologien unterstützt.
| Technologie | Unterstützt |
|---|---|
| SMB 3.0-Protokoll (Server Message Block) | No |
| SMB 3.0 Transparent Failover (TFO) | No |
| SMB 3.0 mit Dateifreigaben mit horizontaler Skalierung (SO) | No |
| Dateisystem mit freigegebenen Clustervolumes (CsvFS) | No |
| Robustes Dateisystem (Resilient File System, ReFS) | No |
SMB unterstützt keine Volumeverwaltungsfunktionen. CsvFS unterstützt das Hinzufügen eines Bereitstellungspunkts auf einem CSV-Volume nicht. ReFS indiziert keine Bereitstellungspunkte.
Hinweis
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 |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winbase.h (Windows.h einschließen) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |