PathCchFindExtension-Funktion (pathcch.h)

  • Artikel

Durchsucht einen Pfad, um die Dateinamenerweiterung zu finden, z. B. ".exe" oder ".ini". Diese Funktion sucht nicht nach einer bestimmten Erweiterung. es sucht nach dem Vorhandensein einer beliebigen Erweiterung.

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

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

Syntax

WINPATHCCHAPI HRESULT PathCchFindExtension(
  [in]  PCWSTR pszPath,
  [in]  size_t cchPath,
  [out] PCWSTR *ppszExt
);

Parameter

[in] pszPath

Ein Zeiger auf den zu durchsuchenden Pfad.

[in] cchPath

Die Größe des Puffers, auf den pszPath in Zeichen verweist, einschließlich des NULL-Abschlusszeichens.

[out] ppszExt

Die Adresse eines Zeigers, der nach erfolgreicher Rückgabe dieser Funktion auf das Zeichen "." zeigt, das der Erweiterung in pszPath vorangestellt ist. Wenn keine Erweiterung gefunden wird, verweist sie auf das endende NULL-Zeichen der Zeichenfolge.

Rückgabewert

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. 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