PathCchRemoveExtension-Funktion (pathcch.h)

  • Artikel

Entfernt die Dateinamenerweiterung aus einem Pfad, falls vorhanden.

Diese Funktion unterscheidet sich von PathRemoveExtension dadurch, dass sie Pfade mit den Präfixen "\", "\?" und "\?\UNC" akzeptiert.

HinweisDiese Funktion sollte anstelle von PathRemoveExtension verwendet werden, um die Möglichkeit eines Pufferüberlaufs zu verhindern.

Syntax

WINPATHCCHAPI HRESULT PathCchRemoveExtension(
  [in, out] PWSTR  pszPath,
  [in]      size_t cchPath
);

Parameter

[in, out] pszPath

Ein Zeiger auf die Pfadzeichenfolge. Wenn diese Funktion erfolgreich zurückgegeben wird, enthält die Zeichenfolge den Pfad mit entfernter Erweiterung. Wenn keine Erweiterung gefunden wurde, bleibt die Zeichenfolge unverändert.

[in] cchPath

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

Rückgabewert

Diese Funktion gibt S_OK zurück, wenn die Funktion erfolgreich war, S_FALSE , wenn keine Erweiterung gefunden wurde, oder andernfalls einen Fehlercode.

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