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 Laufwerkbuchstaben (z. B. "X:\") oder ein Verzeichnis auf einem anderen Volume sein (z. B. "Y:\MountX\"). 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. "\\?\" deaktiviert die Pfadanalyse und wird als Teil des Pfads ignoriert, wie in Benennen eines Volumesbeschrieben.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Wenn der parameter lpszVolumeMountPoint einen Pfad zu einem bereitgestellten Ordner enthält, gibt GetLastErrorERROR_DIR_NOT_EMPTYzurück, auch wenn das Verzeichnis leer ist.
Bemerkungen
Wenn diese Funktion verwendet wird, um ein Volume einem Verzeichnis auf einem anderen Volume zuzuordnen, wird das zugeordnete Verzeichnis als bereitgestellten Ordnerbezeichnet.
Es ist ein Fehler, ein Volume einem Verzeichnis zuzuordnen, das dateien oder Unterverzeichnisse enthält. Dieser Fehler tritt für System- und ausgeblendete Verzeichnisse sowie für andere Verzeichnisse auf und tritt für System- und ausgeblendete Dateien auf.
Wenn bereitgestellte Ordner auf einem Volume auf einem gruppierten Datenträger erstellt werden, werden sie unter bestimmten Umständen möglicherweise unerwartet gelöscht. Informationen zum Erstellen und Konfigurieren von bereitgestellten 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 | 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. Für CSVFS wird kein neuer Bereitstellungspunkt auf die anderen Knoten im Cluster repliziert.
Beispiele
Ein Beispiel finden Sie unter Erstellen eines bereitgestellten Ordners.
Anmerkung
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 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 |