PathCchRemoveExtension-Funktion (pathcch.h)

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.

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