GetFileTitle

Die GetFileTitle -Funktion gibt den Namen der von der LpszFile -Parameter angegebenen Datei zurück.

kurze GetFileTitle) LPCTSTR  LpszFile, / / Zeiger auf den vollständigen Pfad und Dateinamen für die DateiLPTSTRlpszTitle, / / Zeiger auf Puffer, die empfängt DateinameWortCbBuf / / Länge des Puffers);
 

Parameter

lpszFile

Zeiger auf den Namen und den Speicherort einer Datei.

lpszTitle

Zeiger auf einen Puffer, in dem die Funktion besteht darin, den Namen der Datei kopieren.

cbBuf

Gibt die Länge in Zeichen des Puffers, auf den der LpszTitle -parameter.

Rückgabewerte

Wenn die Funktion erfolgreich ist, ist der Rückgabewert 0 (null).

Wenn der Dateiname ungültig ist, ist der Rückgabewert eine negative Zahl.

Wenn der Puffer, auf den mithilfe des Parameters LpszTitle zu klein ist, ist der Rückgabewert eine positive ganze Zahl, die angibt, die erforderliche Puffergröße in Bytes (ANSI-Version) oder 16-Bit-Zeichen (Unicode-Version). Die erforderliche Puffergröße enthält das abschließende Null-Zeichen.

Bemerkungen

Die GetFileTitle -Funktion gibt einen Fehlerwert zurück, wenn der Puffer, auf den der LpszFile -Parameter die folgenden Elemente enthält:

• Eine leere Zeichenfolge
• Eine Zeichenfolge, die einen Platzhalter (1), eckige Klammer ([]), schließende Klammer (]) oder öffnen
• Eine Zeichenfolge, die endet mit einem Doppelpunkt (:), Schrägstrich, Mark (/) oder umgekehrter Schrägstrich (\)
• Eine Zeichenfolge, deren Länge die Länge des Puffers überschritten
• Ein ungültiges Zeichen (z. B. ein Leerzeichen oder ein nicht-druckbaren Zeichen)

Um die Größe des Puffers erforderlich für den Namen einer Datei zu erhalten, rufen Sie die Funktion mit LpszTitle legen Sie auf NULL und CbBuf auf 0 (null) festgelegt. Die Funktion gibt die erforderliche Größe zurück.

GetFileTitle gibt die Zeichenfolge, die das System verwenden, um den Dateinamen für den Benutzer anzuzeigen. Der Anzeigename enthält eine Erweiterung nur, wenn die Einstellung des Benutzers für die Anzeige von Dateinamen. Dies bedeutet, dass die zurückgegebene Zeichenfolge nicht genau die Datei identifizieren kann, wenn sie im Datei-System-Funktionen verwendet wird.

Wenn der LpszTitle -Puffer zu klein ist, gibt GetFileTitle die Größe für den Anzeigenamen zu halten. Es gibt keine garantierte Verbindung zwischen der erforderlichen Größe und den ursprünglich angegebenen Zeichen in der LpszFile -Puffer. In 16-Bit-Windows-basierten Anwendungen auf Win32 portieren, müssen Sie Code zu aktualisieren, die ein solches Verhalten in früheren Versionen des Systems abhängig. Der häufigste Fall ist der aufrufende Code absichtlich GetFileTitle mit LpszTitle auf NULL und CbBuf auf 0 (null) festgelegt, und dann verwendet den Rückgabewert als Index in der LpszFile -Zeichenfolge. Diese Technik wird nicht mehr unterstützt. Sie können in der Regel ähnliche Ergebnisse (und überlegene Leistung) mit Run-Time Bibliotheksfunktionen wie Strrchr, Wcsrchrund _mbsrchr erzielen.

QuickInfo

&Nbsp; Windows NT: Version 3.1 oder höher erforderlich.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Nicht unterstützt.
Header:In commdlg.h deklariert.
Importieren Bibliothek:Verwenden Sie comdlg32.lib.
Unicode:Als Unicode und ANSI-Versionen unter Windows NT implementiert.

Siehe auch

Übersicht über common Dialog Box Library, allgemeine Dialogfeld Feld Funktionen, GetOpenFileName, GetSaveFileName

Index