SetVolumeMountPointA-Funktion (winbase.h)
Ordnet ein Volume einem Laufwerkbuchstaben oder einem Verzeichnis auf einem anderen Volume zu.
Syntax
BOOL SetVolumeMountPointA(
[in] LPCSTR lpszVolumeMountPoint,
[in] LPCSTR lpszVolumeName
);
Parameter
[in] lpszVolumeMountPoint
Der Benutzermoduspfad, der dem Volume zugeordnet werden soll. Dies kann ein Laufwerkbuchstabe (z. B. "X:\") oder ein Verzeichnis auf einem anderen Volume (z. B. "Y:\MountX") sein. Die Zeichenfolge muss mit einem nachfolgenden umgekehrten Schrägstrich ('') enden.
[in] lpszVolumeName
Ein Volume-GUID-Pfad für das Volume. Diese Zeichenfolge muss das Format "\\?\Volume{GUID}" aufweisen, wobei GUID eine GUID ist, die das Volume identifiziert. Die "\\?" deaktiviert die Pfadanalyse und wird als Teil des Pfads ignoriert, wie unter Benennen eines Volumes erläutert.
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 der lpszVolumeMountPoint-Parameter einen Pfad zu einem eingebundenen Ordner enthält, gibt GetLastErrorERROR_DIR_NOT_EMPTY zurück, auch wenn das Verzeichnis leer ist.
Hinweise
Wenn diese Funktion verwendet wird, um ein Volume einem Verzeichnis auf einem anderen Volume zuzuordnen, wird das zugeordnete Verzeichnis als eingebundener Ordner bezeichnet.
Es ist ein Fehler, ein Volume einem Verzeichnis zuzuordnen, in dem dateien oder Unterverzeichnisse enthalten sind. Dieser Fehler tritt für Systemverzeichnisse und ausgeblendete Verzeichnisse sowie andere Verzeichnisse auf und tritt für Systemdateien und ausgeblendete Dateien auf.
Wenn eingebundene Ordner auf einem Volume auf einem gruppierten Datenträger erstellt werden, können sie unter bestimmten Umständen unerwartet gelöscht werden. Informationen zum Erstellen und Konfigurieren von eingebundenen Ordnern, um sicherzustellen, dass dies nicht geschieht, finden Sie unter Clusterdatenträger- und Laufwerkverbindungsprobleme.
IIn 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. Für CsvFS wird ein neuer Bereitstellungspunkt nicht auf die anderen Knoten im Cluster repliziert.
Beispiele
Ein Beispiel finden Sie unter Erstellen eines eingebundenen Ordners.
Hinweis
Der winbase.h-Header definiert SetVolumeMountPoint 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 nicht codierungsneutralem Code 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 (einschließlich Windows.h) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |