SHPathPrepareForWriteW-Funktion (shlobj_core.h)
Überprüft, ob der Pfad vorhanden ist. Dies umfasst das erneute Einbinden zugeordneter Netzwerklaufwerke, die Aufforderung zum erneuten Auswerfen von Auswerfmedien, das Erstellen der Pfade, das Auffordern zum Formatieren der Medien und die Bereitstellung der entsprechenden Benutzeroberflächen, falls erforderlich. Lese-/Schreibberechtigungen für das Medium werden nicht überprüft.
Syntax
SHSTDAPI SHPathPrepareForWriteW(
[in, optional] HWND hwnd,
[in, optional] IUnknown *punkEnableModless,
[in] LPCWSTR pszPath,
DWORD dwFlags
);
Parameter
[in, optional] hwnd
Typ: HWND
Ein Handle für ein Fenster, das das übergeordnete Fenster angibt, das für alle Benutzeroberflächenfenster verwendet werden soll, die erstellt werden müssen. Wenn dieser Wert auf NULL festgelegt ist, werden keine Benutzeroberflächenfenster erstellt.
[in, optional] punkEnableModless
Typ: IUnknown*
Ein Zeiger auf eine IUnknown-Schnittstelle , die das IOleInPlaceActiveObject-Objekt angibt, das die EnableModeless-Methode implementiert.
[in] pszPath
Typ: LPCTSTR
Ein Zeiger auf eine null-endende Zeichenfolge mit maximaler Länge MAX_PATH, die den Pfad angibt, der als gültig für das Schreiben überprüft werden soll. Dies kann ein UNC- oder Dateilaufwerkspfad sein.
dwFlags
Art: DWORD
Flags, die Verhaltensoptionen bestimmen. Für diesen Parameter ist eine Kombination der folgenden Werte gültig.
SHPPFW_NONE
Erstellen Sie keine neuen Verzeichnisse.
SHPPFW_DEFAULT
Standard. Fordern Sie den Benutzer nicht auf, wenn ein Verzeichnis erstellt werden muss. Dies ist identisch mit SHPPFW_DIRCREATE. Übergeben Sie nicht mit SHPPFW_ASKDIRCREATE.
SHPPFW_DIRCREATE
Erstellen Sie Verzeichnisse, ohne den Benutzer dazu aufzufordern. Übergeben Sie nicht mit SHPPFW_ASKDIRCREATE.
SHPPFW_ASKDIRCREATE
Fordern Sie den Benutzer vor dem Erstellen von Verzeichnissen auf. Übergeben Sie nicht mit SHPPFW_DIRCREATE.
SHPPFW_IGNOREFILENAME
Das letzte Element in pszPath ist ein Dateiname. Ignorieren Sie also. Wenn z. B. pszPath="C:\MyDir\MyFile.doc", verwenden Sie nur "C:\MyDir". Wenn pszPath="C:\MyFirDir\MySecDir", verwenden Sie nur "C:\MyFirDir".
SHPPFW_NOWRITECHECK
Derzeit nicht implementiert.
SHPPFW_MEDIACHECKONLY
Windows XP oder höher. Unterdrückt das Fehlermeldungsfeld "nicht zugänglich", das angezeigt wird, wenn ein anderer Fehler als ein Benutzerabbruch auftritt und hwnd nicht NULL ist.
Rückgabewert
Typ: HRESULT
Gibt S_OK zurück, wenn der Pfad verfügbar ist, oder andernfalls einen Fehlercode. Beachten Sie, dass ein Rückgabewert von S_OK nicht bedeutet, dass das Medium beschreibbar ist. dies bedeutet einfach, dass der Pfad verfügbar ist.
Hinweise
Die primäre Verwendung dieser Funktion besteht darin, dass ein Programm einen Pfad vor der Verwendung überprüft und die erforderliche Benutzeroberfläche anzeigt, um den Benutzer aufzufordern. Wenn beispielsweise der Datenträger in Laufwerk A: fehlt, wird ein Fenster angezeigt, in dem der Benutzer aufgefordert wird, den Datenträger einzulegen.
Hinweis
Der shlobj_core.h-Header definiert SHPathPrepareForWrite 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 |
---|---|
Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | shlobj_core.h (einschließlich Shlobj.h, Shlobj_core.h) |
Bibliothek | Shell32.lib |
DLL | Shell32.dll (Version 5.0 oder höher) |
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für