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)