FindFirstVolumeMountPointA-Funktion (winbase.h)
Ruft den Namen eines bereitgestellten Ordners auf dem angegebenen Volume ab. FindFirstVolumeMountPoint- wird verwendet, um mit dem Scannen der bereitgestellten 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 auf bereitgestellte Ordner überprüft werden soll. Ein nachfolgender 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 bereitgestellten Ordner empfängt, in TCHARs.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Suchhandle, das in einem nachfolgenden Aufruf der FindNextVolumeMountPoint und FindVolumeMountPointClose Funktionen verwendet wird.
Wenn die Funktion keinen bereitgestellten Ordner auf dem Volume findet, ist der Rückgabewert der INVALID_HANDLE_VALUE Fehlercode. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
Die FindFirstVolumeMountPoint--Funktion öffnet ein Suchhandle für bereitgestellte 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 bereitgestellten Ordnern zu suchen. Wenn der Suchhandle nicht mehr benötigt wird, schließen Sie es mit der FindVolumeMountPointClose--Funktion.
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 von 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 FindFirstVolumeMountPoint als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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 |