PathCchRenameExtension-Funktion (pathcch.h)

  • Artikel

Ersetzt die Erweiterung eines Dateinamens am Ende einer Pfadzeichenfolge durch eine neue Erweiterung. Wenn die Pfadzeichenfolge nicht mit einer Erweiterung endet, wird die neue Erweiterung hinzugefügt.

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

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

Syntax

WINPATHCCHAPI HRESULT PathCchRenameExtension(
  [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, verweist dieser Wert auf dieselbe Zeichenfolge, jedoch mit der umbenannten oder hinzugefügten Erweiterung.

[in] cchPath

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

[in] pszExt

Ein Zeiger auf die neue Erweiterungszeichenfolge. Das führende Zeichen "." ist optional. Bei einer leeren Zeichenfolge ("") wird jede vorhandene Erweiterung in der Pfadzeichenfolge entfernt.

Rückgabewert

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

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