GetFileTitle

De functie GetFileTitle retourneert de naam van het bestand lpszFile de parameter.

korte GetFileTitle ()  LPCTSTR  lpszFile, / / verwijzing naar het volledige pad en de bestandsnaam voor het bestandLPTSTRlpszTitle, / / pointer naar de buffer die ontvangt bestandsnaamWORDcbBuf / / lengte van buffer);
 

Parameters

lpszFile

Pointer naar de naam en locatie van een bestand.

lpszTitle

Aanwijzer naar een buffer waarin de functie is de naam van het bestand te kopiëren.

cbBuf

Hiermee geeft u de lengte, in tekens, van de buffer waarnaar door de parameter lpszTitle.

Retourwaarden

Als de functie slaagt, is de retourwaarde nul.

Als de bestandsnaam ongeldig is, is de retourwaarde een negatief getal.

Als de buffer waarnaar door de parameter lpszTitle te klein is, is de retourwaarde een positief geheel getal waarmee de vereiste buffergrootte in bytes (ANSI-versie) of 16-bits tekens (Unicode versie). De vereiste buffergrootte bevat het afsluitende null-teken.

Opmerkingen

De GetFileTitle functie geeft een foutwaarde als resultaat als de buffer waarnaar door de parameter lpszFile een van de volgende elementen bevat:

• Een lege tekenreeks
• Een tekenreeks met een jokerteken (**) openen beugel ([]), of vierkant haakje sluiten (])
• Een tekenreeks die met een dubbele punt eindigt (:), slash mark (/) of backslash (\)
• Een tekenreeks waarvan de lengte de lengte van de buffer overschreden
• Een ongeldig teken (bijvoorbeeld een spatie of een niet-afdrukbare teken)

Om de buffergrootte van de die nodig zijn voor de naam van een bestand, roept u de functie met lpszTitle ingesteld op NULL en cbBuf ingesteld op nul. De functie geeft als resultaat de vereiste grootte.

GetFileTitle retourneert de tekenreeks die het systeem gebruiken zou om de bestandsnaam voor de gebruiker weer te geven. De weergavenaam bevat een uitbreiding alleen als dat is de voorkeuren van de gebruiker voor het weergeven van bestandsnamen. Dit betekent dat de geretourneerde tekenreeks niet nauwkeurig het bestand vaststellen als het wordt gebruikt in de aanroepen van bestand systeemfuncties.

Als de lpszTitle buffer te klein is, geeft GetFileTitle de grootte nodig is voor de weergavenaam. Er is geen gegarandeerde verbinding tussen de vereiste grootte en de tekens die oorspronkelijk is opgegeven in de buffer lpszFile . In het porten van 16-bits Windows-toepassingen naar Win32, zal u wilt bijwerken een code die is gebaseerd op dergelijk gedrag in eerdere versies van het systeem. De meest voorkomende geval is code die opzettelijk GetFileTitle met lpszTitle ingesteld op NULL en cbBuf ingesteld op nul aanroept en gebruikt u vervolgens de geretourneerde waarde als een index in de tekenreeks lpszFile . Deze techniek wordt niet langer ondersteund. U kunt meestal vergelijkbare resultaten (en superieure prestaties) bereiken met run-time library functies zoals strrchr, wcsrchren _mbsrchr.

Syntaxisinfo

nbsp; Windows &NT: versie 3.1 of hoger vereist.
Windows:Windows 95 of hoger vereist.
Windows CE:Niet-ondersteunde.
Header:Verklaard in commdlg.h.
Bibliotheek importeren:Gebruik comdlg32.lib.
Unicode:Geïmplementeerd als Unicode en ANSI-versies van Windows NT.

Zie ook

Overzicht van bibliotheek het gemeenschappelijk dialoogvenster, gemeenschappelijk dialoogvenster vak functies, GetOpenFileName, GetSaveFileName