PathProcessCommand-Funktion (shlobj.h)

Artikel
03/02/2024

Veraltet. Verarbeitet eine Zeichenfolge, die eine Befehlszeile enthält, und generiert eine Zeichenfolge mit geeigneten Anführungszeichen, wobei bei Bedarf Argumente angefügt werden.

Syntax

LONG PathProcessCommand(
  [in]  PCWSTR pszSrc,
  [out] PWSTR  pszDest,
        int    cchDest,
        DWORD  dwFlags
);

Parameter

[in] pszSrc

Typ: PCWSTR

Ein Zeiger auf eine NULL-endende Zeichenfolge, die die zu verarbeitende Befehlszeile enthält.

[out] pszDest

Typ: PWSTR

Zeiger auf einen Puffer, der eine Unicode-Zeichenfolge mit NULL-Beendigung mit den entsprechenden Anführungszeichen empfängt. Legen Sie diesen Parameter auf NULL fest, um zu bestimmen, wie groß dieser Puffer sein muss. Die Funktion gibt die erforderliche Puffergröße zurück.

cchDest

Typ: int

Die maximale Anzahl von Zeichen, die in pszDest eingefügt werden können, ohne das abschließende NULL-Zeichen. Wenn dieser Wert zu klein ist, schlägt die Funktion fehl.

dwFlags

Art: DWORD

Flags, die die Prozedur steuern. Mindestens einer der folgenden Werte:

PPCF_ADDQUOTES (0x00000001)

Fügen Sie Anführungszeichen hinzu, wenn der Pfad sie erfordert.

PPCF_ADDARGUMENTS (0x00000003)

Fügen Sie nachfolgende Argumente an die Ausgabezeichenfolge an. Dieser Wert enthält PPCF_ADDQUOTES.

PPCF_NODIRECTORIES (0x00000010)

Stimmen Sie die Eingabezeichenfolge nicht mit Ordnern ab, nur mit Dateiobjekten.

PPCF_FORCEQUALIFY (0x00000040)

Qualifizieren Sie auch nicht relative Dateinamen.

PPCF_LONGESTPOSSIBLE (0x00000080)

Wählen Sie immer den längsten möglichen ausführbaren Namen aus.

Rückgabewert

Typ: LONG

Gibt bei erfolgreicher Ausführung einen positiven Wert zurück. Wenn lpDest auf NULL festgelegt ist, gibt die Funktion die erforderliche Puffergröße in Zeichen zurück, einschließlich des abschließenden NULL-Zeichens. Wenn der Aufruf fehlschlägt, gibt die Funktion einen negativen Wert zurück.

Hinweise

Hinweis Diese Funktion ist über Windows XP Service Pack 2 (SP2) und Windows Server 2003 verfügbar. Es wird in Windows Vista und höheren Versionen von Windows nicht unterstützt.

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.h
Bibliothek	Shell32.lib
DLL	Shell32.dll (Version 5.0 oder höher)

Freigeben über