Freigeben über

PathCchAddExtension-Funktion (pathcch.h)

  • Artikel

Fügt einer Pfadzeichenfolge eine Dateinamenerweiterung hinzu.

Diese Funktion unterscheidet sich von PathAddExtension darin, dass pfade mit den Präfixen "\", "\?" und "\?\UNC" akzeptiert werden.

Hinweis Diese Funktion sollte anstelle von PathAddExtension verwendet werden, um die Möglichkeit eines Pufferüberlaufs zu verhindern.

Syntax

WINPATHCCHAPI HRESULT PathCchAddExtension(
  [in, out] PWSTR  pszPath,
  [in]      size_t cchPath,
  [in]      PCWSTR pszExt
);

Parameter

[in, out] pszPath

Ein Zeiger auf die Pfadzeichenfolge. Wenn diese Funktion erfolgreich zurückgegeben wird, enthält der Puffer die Zeichenfolge mit der angefügten Erweiterung. Dieser Wert sollte nicht NULL sein.

Hinweis Wenn die ursprüngliche Zeichenfolge bereits über eine Dateinamenerweiterung verfügt, wird keine neue Erweiterung hinzugefügt, und die ursprüngliche Zeichenfolge bleibt unverändert.

[in] cchPath

Die Größe des Puffers, auf den pszPath in Zeichen verweist.

[in] pszExt

Ein Zeiger auf die Dateinamenerweiterungszeichenfolge. Diese Zeichenfolge kann entweder mit oder ohne vorangehenden Punkt (".ext" oder "ext") angegeben werden.

Rückgabewert

Diese Funktion gibt einen HRESULT-Code zurück, einschließlich des folgenden.

Rückgabecode BESCHREIBUNG
S_OK
 Die Funktion wurde erfolgreich ausgeführt. Beachten Sie, dass dies auch den Fall einer leeren Erweiterung umfasst, z. B. eines Punkts, auf den keine Zeichen folgen. In diesem Fall wird die ursprüngliche Zeichenfolge unverändert zurückgegeben.
E_INVALIDARG
 Dieser Wert kann durch mehrere Dinge verursacht werden, z. B. durch den pszPath-Param , der auf NULL festgelegt wird, der cchPath auf 0 oder einen Wert größer als PATHCCH_MAX_CCH festgelegt wird, oder die Erweiterungszeichenfolge, die unzulässige Zeichen enthält oder anderweitig keine gültige Erweiterung ist.
S_FALSE
 Die ursprüngliche Zeichenfolge verfügt bereits über eine Erweiterung.
PATHCCH_E_FILENAME_TOO_LONG
 Der Puffer ist zu klein, um die zurückgegebene Zeichenfolge zu speichern.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile pathcch.h
Bibliothek Pathcch.lib