DefineDosDeviceW-Funktion (fileapi.h)
Definiert oder löscht MS-DOS-Gerätenamen oder definiert sie neu.
Syntax
BOOL DefineDosDeviceW(
[in] DWORD dwFlags,
[in] LPCWSTR lpDeviceName,
[in, optional] LPCWSTR lpTargetPath
);
Parameter
[in] dwFlags
Die steuerbaren Aspekte der DefineDosDevice-Funktion . Dieser Parameter kann einen oder mehrere der folgenden Werte aufweisen.
| Wert | Bedeutung |
|---|---|
|
Wenn dieser Wert zusammen mit DDD_REMOVE_DEFINITION angegeben wird, verwendet die Funktion eine genaue Übereinstimmung, um zu bestimmen, welche Zuordnung entfernt werden soll. Verwenden Sie diesen Wert, um sicherzustellen, dass Sie nicht definierte Elemente löschen. |
|
Senden Sie die WM_SETTINGCHANGE-Nachricht nicht. Standardmäßig wird diese Nachricht gesendet, um die Shell und anwendungen über die Änderung zu benachrichtigen. |
|
Verwendet die lpTargetPath-Zeichenfolge unverändert. Andernfalls wird es von einem MS-DOS-Pfad in einen Pfad konvertiert. |
|
Entfernt die angegebene Definition für das angegebene Gerät. Um zu bestimmen, welche Definition entfernt werden soll, führt die Funktion die Liste der Zuordnungen für das Gerät durch und sucht nach einer Übereinstimmung von lpTargetPath mit einem Präfix jeder Zuordnung, die diesem Gerät zugeordnet ist. Die erste Zuordnung, die übereinstimmt, ist die, die entfernt wurde, und die Funktion gibt dann zurück.
Wenn lpTargetPathNULL oder ein Zeiger auf eine NULL-Zeichenfolge ist, entfernt die Funktion die erste Zuordnung, die dem Gerät zugeordnet ist, und füllt die zuletzt gepushte Zuordnung auf. Wenn nichts mehr eingeblendet werden kann, wird der Gerätename entfernt. Wenn dieser Wert nicht angegeben wird, wird die Zeichenfolge, auf die der parameter lpTargetPath verweist, zur neuen Zuordnung für dieses Gerät. |
[in] lpDeviceName
Ein Zeiger auf eine MS-DOS-Gerätenamenzeichenfolge, die das Gerät angibt, das die Funktion definiert, neu definiert oder löscht. Die Gerätenamenzeichenfolge darf keinen Doppelpunkt als letztes Zeichen aufweisen, es sei denn, ein Laufwerkbuchstabe wird definiert, neu definiert oder gelöscht. Laufwerk C wäre beispielsweise die Zeichenfolge "C:". In keinem Fall ist ein nachgestellter umgekehrter Schrägstrich (\) zulässig.
[in, optional] lpTargetPath
Ein Zeiger auf eine Pfadzeichenfolge, die dieses Gerät implementiert. Die Zeichenfolge ist eine MS-DOS-Pfadzeichenfolge, es sei denn, das DDD_RAW_TARGET_PATH-Flag wird angegeben. In diesem Fall handelt es sich bei dieser Zeichenfolge um eine Pfadzeichenfolge.
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.
Bemerkungen
MS-DOS-Gerätenamen werden als Knoten im Objektnamespace gespeichert. Der Code, der einen MS-DOS-Pfad in einen entsprechenden Pfad konvertiert, verwendet diese Verbindungen, um MS-DOS-Geräte und Laufwerkbuchstaben zuzuordnen. Mit der DefineDosDevice-Funktion kann eine Anwendung die Verbindungen ändern, die zum Implementieren des MS-DOS-Gerätenamespaces verwendet werden.
Verwenden Sie die QueryDosDevice-Funktion , um die aktuelle Zuordnung für einen bestimmten MS-DOS-Gerätenamen abzurufen oder eine Liste aller dem System bekannten MS-DOS-Geräte abzurufen.
Verwenden Sie die SetVolumeMountPoint-Funktion , um eine Laufwerkbuchstabenzuweisung zu definieren, die bootübergreifend und nicht eine Netzwerkfreigabe persistent ist. Wenn dem volume, das eingebunden werden soll, bereits ein Laufwerkbuchstabe zugewiesen ist, verwenden Sie die DeleteVolumeMountPoint-Funktion , um die Zuweisung zu entfernen.
Laufwerkbuchstaben und Gerätenamen, die zur Systemstartzeit definiert wurden, sind vor Neudefinition und Löschen geschützt, es sei denn, der Benutzer ist Administrator.
Ab Windows XP erstellt diese Funktion einen Gerätenamen für einen Aufrufer, der nicht im Kontext "LocalSystem" in seinem eigenen lokalen MS-DOS-Gerätenamespace ausgeführt wird. Wenn der Aufrufer im Kontext "LocalSystem" ausgeführt wird, erstellt die Funktion den Gerätenamen im globalen MS-DOS-Gerätenamespace. Weitere Informationen finden Sie unter Definieren von MS DOS-Gerätenamen und Dateinamen, Pfaden und Namespaces.
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) | Nein |
| SMB 3.0 mit Dateifreigaben mit horizontaler Skalierung (SO) | Nein |
| Dateisystem mit freigegebenen Clustervolumes (CsvFS) | Nein |
| Robustes Dateisystem (Resilient File System, ReFS) | No |
SMB unterstützt keine Volumeverwaltungsfunktionen. Für CsvFs wird ein neuer Name nicht auf die anderen Knoten im Cluster repliziert.
Beispiele
Ein Beispiel finden Sie unter Bearbeiten von Laufwerkbuchstabenzuweisungen.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | fileapi.h (Einschließen von Windows.h) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |