GetFileTitle

Funkcja GetFileTitle zwraca nazwę pliku określone przez parametr lpszFile.

krótkie (GetFileTitle)  LPCTSTR  lpszFile, / / wskaźnik pełną ścieżkę i nazwę plikuLPTSTRlpszTitle, / / wskaźnik do buforu, który odbiera nazwa_plikuProgram WORDcbBuf / / długość buforu);
 

Parametry

lpszFile

Wskaźnik nazwę i lokalizację pliku.

lpszTitle

Wskaźnik do buforu, do której funkcja jest skopiowanie nazwa pliku.

cbBuf

Określa długość znaków, buforu wskazywanego przez parametr lpszTitle.

Zwraca wartości

Jeśli funkcja, wartość zwracany jest zero.

Jeśli nazwa pliku jest nieprawidłowa, wartość zwracany jest to liczba ujemna.

Jeśli bufor wskazywanego przez parametr lpszTitle jest zbyt mały, wartość zwracany jest dodatnia liczba całkowita, która określa rozmiar buforu wymagany w bajtach (wersja ANSI) lub znaków 16-bitowych (wersja Unicode). Rozmiar buforu wymagany obejmuje kończącego znaku null.

Uwagi

Funkcja GetFileTitle zwraca wartość błędu, jeśli bufor wskazywanego przez parametr lpszFile zawiera następujące elementy:

• Pusty ciąg znaków
• Ciąg zawierający symbol wieloznaczny **, otwieranie nawias kwadratowy ([]) lub zamykający nawias kwadratowy (])
• Ciąg, który kończy się znakiem dwukropka (:), ukośnik znaku (/) lub odwróconej kreski ułamkowej (\)
• Ciąg, którego długość przekroczył długość buforu
• Nieprawidłowy znak (na przykład spację lub znak nie do drukowania)

Aby uzyskać rozmiar buforu dla nazwy pliku, należy wywołać funkcję z lpszTitle ustawiona na wartość NULL i cbBuf ustawiony na zero. Funkcja zwróci wymagany rozmiar.

GetFileTitle zwraca ciąg znaków, który system będzie służy do wyświetlania nazwy pliku do użytkownika. Nazwa wyświetlana zawiera rozszerzenie tylko wtedy, gdy jest to preferencji użytkownika do wyświetlania nazw plików. Oznacza to, że zwrócony ciąg może nie dokładnie zidentyfikować plik jeśli jest używany w wywołaniach funkcji systemu plików.

Jeśli bufor lpszTitle jest zbyt mały, GetFileTitle zwraca rozmiar musi posiadać nazwę wyświetlaną. Brakuje gwarantowanej połączenia między wymagany rozmiar i znaki pierwotnie określony w buforze lpszFile . W przenoszenie aplikacji 16-bitowych opartych na systemie Windows do systemu Win32, należy zaktualizować kod, który opiera się na takie zachowanie w poprzednich wersjach systemu. Najczęściej sprawa jest kodem, który celowo wywołuje GetFileTitle z lpszTitle ustawiona na wartość NULL i cbBuf zestaw do zera, a następnie używa wartości zwracanej jako indeks w ciągu lpszFile . Ta technika jest już obsługiwane. Można zazwyczaj osiągnąć podobne wyniki (i najwyższej wydajności) z run-time library funkcje takie jak strrchr, wcsrchri _mbsrchr.

Skrócone informacje

nbsp; Windows &NT: wymagana wersja 3.1 lub nowsza.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Nieobsługiwane.
Nagłówka:Zadeklarowane w commdlg.h.
Importowanie biblioteki:Należy użyć comdlg32.lib.
Unicode:Implementowane jako wersje Unicode i ANSI w systemie Windows NT.

Zobacz też

Wspólny omówienie biblioteki okna dialogowego, wspólne funkcje pole dialogowe, GetOpenFileName, GetSaveFileName