SHPathPrepareForWriteA-Funktion (shlobj_core.h)

Artikel
11/20/2024

Überprüft, ob der Pfad vorhanden ist. Dies umfasst das erneute Bereitstellen zugeordneter Netzwerklaufwerke, die Aufforderung, dass ausgeworfene Medien erneut eingefügt werden sollen, die Pfade zu erstellen, die Medien zur Formatierung aufzufordern und ggf. die entsprechenden Benutzeroberflächen bereitzustellen. Lese-/Schreibberechtigungen für das Medium werden nicht überprüft.

Syntax

SHSTDAPI SHPathPrepareForWriteA(
  [in, optional] HWND     hwnd,
  [in, optional] IUnknown *punkEnableModless,
  [in]           LPCSTR   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 mit Null beendete Zeichenfolge mit maximaler Länge MAX_PATH, die den zu überprüfenden Pfad für das Schreiben angibt. Dies kann ein UNC- oder Dateilaufwerkpfad sein.

dwFlags

Typ: DWORD-

Flags, die Verhaltensoptionen bestimmen. Dieser Parameter kann eine Kombination aus den folgenden Werten sein.

SHPPFW_NONE

Erstellen Sie keine neuen Verzeichnisse.

SHPPFW_DEFAULT

Vorgabe. 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, also ignorieren. Wenn z. B. pszPath="C:\MyDir\MyFile.doc", verwenden Sie nur "C:\MyDir". Wenn pszPath="C:\MyFirDir\MySecDir" verwenden, 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 ein Fehlercode vorliegt. Beachten Sie, dass ein Rückgabewert von S_OK nicht bedeutet, dass das Medium schreibbar ist; es bedeutet einfach, dass der Pfad verfügbar ist.

Bemerkungen

Die primäre Verwendung dieser Funktion dient dazu, dass ein Programm einen Pfad überprüft, bevor er ihn verwendet 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 einzufügen.

Anmerkung

Der header shlobj_core.h 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
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	shlobj_core.h (einschließlich Shlobj.h, Shlobj_core.h)
Library	Shell32.lib
DLL-	Shell32.dll (Version 5.0 oder höher)

Freigeben über