Freigeben über


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

Siehe auch

FindNextVolumeMountPoint-

FindVolumeMountPointClose

bereitgestellte Ordner

Volumenverwaltungsfunktionen