GetFileTitle

Funksjonen GetFileTitle returnerer navnet på filen som ble identifisert av parameteren lpszFile.

GetFileTitle ( ) kort LPCTSTR  lpszFile, / / peker til hele banen og filnavnet for filenLPTSTRlpszTitle, / / pekeren til å bufre som mottar filnavnWORDcbBuf / / lengden på bufferen);
 

Parametere

lpszFile

Pekeren til navnet og plasseringen til en fil.

lpszTitle

Pekeren til en buffer i hvilke funksjonen er å kopiere navnet på filen.

cbBuf

Angir lengden, i tegn, på bufferen som koblingen leder til parameteren lpszTitle.

Returverdier

Hvis funksjonen lykkes, er returverdien null.

Hvis filnavnet er ugyldig, er returverdien et negativt tall.

Hvis bufferen koblingen leder til parameteren lpszTitle er for liten, er returverdien et positivt heltall som angir påkrevd bufferstørrelse i byte (ANSI-versjonen) eller 16-biters tegn (Unicode-versjonen). Den påkrevde bufferstørrelsen inkluderer nulltegnet.

Merknader

Funksjonen GetFileTitle returnerer en feilverdi Hvis bufferen koblingen leder til parameteren lpszFile inneholder noen av følgende elementer:

• En tom streng
• En streng som inneholder et jokertegn Lock+stjerne(*), åpne hakeparentes ([]), eller en høyre hakeparentes (])
• En streng som slutter med et kolon (:), skråstrek (/) for merket eller omvendt skråstrek (\)
• En streng med lengden overskrider lengden på bufferen
• Et ugyldig tegn (for eksempel et mellomrom eller et innstillinger tegn)

For å få bufferstørrelsen som er nødvendig for navnet på en fil, kan du kalle funksjonen med lpszTitle satt til NULL og cbBuf satt til null. Returnerer funksjonen den påkrevde størrelsen.

GetFileTitle returnerer strengen som systemet bruker til å vise filnavnet for brukeren. Visningsnavnet inneholder filtypen bare hvis det er brukerens preferanser for å vise filnavn. Dette betyr at den returnerte strengen ikke kan nøyaktig identifisere filen hvis den brukes i kall til filen systemfunksjoner.

Hvis lpszTitle -bufferen er for liten, returnerer GetFileTitle størrelse som kreves til å oppbevare visningsnavnet. Det er ingen garantert forbindelse mellom den påkrevde størrelsen og tegnene som er opprinnelig angitt i lpszFile -bufferen. I porting 16-biters Windows-baserte programmer til Win32, må du oppdatere noen kode som avhenger av slik oppførsel i tidligere versjoner av systemet. Det mest vanlige tilfellet er kode som bevisst kaller GetFileTitle med lpszTitle satt til NULL og cbBuf satt til null, og deretter bruker returverdien som en indeks i strengen lpszFile . Denne teknikken, støttes ikke lenger. Du kan vanligvis oppnå samme resultat (og overlegen ytelse) med run-time biblioteksfunksjoner som strrchr, wcsrchrog _mbsrchr.

Hurtiginformasjon

nbsp; Windows &NT: krever versjon 3.1 eller senere.
Windows:Krever Windows 95 eller senere.
Windows CE:Som ikke støttes.
Topptekst:Deklarert i commdlg.h.
Importere biblioteket:Bruk comdlg32.lib.
Unicode:Implementert som Unicode- og ANSI-versjoner på Windows NT.

Se også

Felles biblioteket dialogboksoversikt, felles dialogboksen fungerer, GetOpenFileName, GetSaveFileName