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

Siehe auch

FindFirstVolumeMountPoint

FindVolumeMountPointClose

Eingebundene Ordner

Volumeverwaltungsfunktionen