FindFirstVolumeMountPointA-Funktion (winbase.h)
Ruft den Namen eines eingebundenen Ordners auf dem angegebenen Volume ab. FindFirstVolumeMountPoint wird verwendet, um mit der Überprüfung der eingebundenen Ordner auf einem Volume zu beginnen.
Syntax
HANDLE FindFirstVolumeMountPointA(
[in] LPCSTR lpszRootPathName,
[out] LPSTR lpszVolumeMountPoint,
[in] DWORD cchBufferLength
);
Parameter
[in] lpszRootPathName
Ein Volume-GUID-Pfad für das Volume, das nach eingebundenen Ordnern gesucht werden soll. Ein nachgestellter umgekehrter Schrägstrich ist erforderlich.
[out] lpszVolumeMountPoint
Ein Zeiger auf einen Puffer, der den Namen des ersten bereitgestellten Ordners empfängt, der gefunden wird.
[in] cchBufferLength
Die Länge des Puffers, der den Pfad zum eingebundenen Ordner in TCHARs empfängt.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Suchhandle, das in einem nachfolgenden Aufruf der Funktionen FindNextVolumeMountPoint und FindVolumeMountPointClose verwendet wird.
Wenn die Funktion keinen eingebundenen Ordner auf dem Volume findet, ist der Rückgabewert der INVALID_HANDLE_VALUE Fehlercode. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Die FindFirstVolumeMountPoint-Funktion öffnet ein Suchhandle für eingebundene Ordner und gibt Informationen zum ersten bereitgestellten Ordner zurück, der auf dem angegebenen Volume gefunden wird. Nachdem das Suchhandle eingerichtet wurde, können Sie die FindNextVolumeMountPoint-Funktion verwenden, um nach anderen eingebundenen Ordnern zu suchen. Wenn das Suchhandle nicht mehr benötigt wird, schließen Sie es mit der Funktion FindVolumeMountPointClose .
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 nicht davon ausgehen, dass die Reihenfolge der eingebundenen Ordner, die von diesen Funktionen zurückgegeben werden, mit der Reihenfolge der eingebunden Ordner korreliert, 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 FindFirstVolumeMountPoint 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
| 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 |