GetFileTitle

La funzione GetFileTitle restituisce il nome del file identificato dal parametro lpszFile.

breve GetFileTitle ( LPCTSTR  lpszFile, / / puntatore al percorso completo e il nome file per il fileLPTSTRlpszTitle, / / puntatore buffer che riceve nomefileWORDcbBuf / / lunghezza del buffer);
 

Parametri

lpszFile

Puntatore al nome e il percorso di un file.

lpszTitle

Puntatore a un buffer in cui la funzione è quella di copiare il nome del file.

cbBuf

Specifica la lunghezza, in caratteri, del buffer a cui puntata il parametro lpszTitle.

Valori restituiti

Se la funzione ha esito positivo, il valore restituito è zero.

Se il nome del file non è valido, il valore restituito è un numero negativo.

Se il buffer a cui puntato il parametro lpszTitle è troppo piccolo, il valore restituito è un numero intero positivo che specifica la dimensione del buffer necessaria, in byte (versione ANSI) o in caratteri (versione Unicode) a 16 bit. La dimensione del buffer richiesta include il carattere di terminazione null.

Osservazioni

La funzione GetFileTitle restituisce un valore di errore se il buffer a cui puntato il parametro lpszFile contiene uno dei seguenti elementi:

• Una stringa vuota
• Una stringa che contiene un carattere jolly (*), apertura staffa ([]) o parentesi di chiusura (])
• Una stringa che termina con due punti (:), slash (/) marchio o backslash (\)
• Una stringa di cui lunghezza supera la lunghezza del buffer
• Un carattere non valido (ad esempio, uno spazio o un carattere non stampabile)

Per ottenere la dimensione del buffer necessaria per il nome di un file, chiamare la funzione con lpszTitle impostato su NULL e cbBuf impostato su zero. La funzione restituirà la dimensione necessaria.

GetFileTitle restituisce la stringa che il sistema sarebbe utilizzare per visualizzare il nome del file per l'utente. Il nome visualizzato include un'estensione solo se questa è la preferenza dell'utente per visualizzare i nomi dei file. Questo significa che la stringa restituita può non individuare con precisione il file se viene utilizzato nelle chiamate a funzioni di sistema di file.

Se il buffer di lpszTitle è troppo piccolo, GetFileTitle restituisce la dimensione richiesta per contenere il nome visualizzato. Non c'è alcuna connessione garantiti tra le dimensioni necessarie e i caratteri specificati originariamente nel buffer lpszFile . Nel porting di applicazioni basate su Windows a 16 bit per Win32, è necessario aggiornare il codice che si basa su tale comportamento nelle versioni precedenti del sistema. Il caso più comune è il codice che chiama deliberatamente GetFileTitle con lpszTitle impostato su NULL e cbBuf insieme a zero e quindi utilizza il valore restituito come indice nella stringa lpszFile . Questa tecnica non è più supportata. È solitamente possibile ottenere risultati simili (e prestazioni superiori) con funzioni di libreria runtime come strrchr, wcsrchre mbsrchr.

Descrizione

nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Non supportato.
Intestazione:Dichiarati in commdlg.h.
Importare librerie:Utilizzare comdlg32.lib.
Unicode:Implementato come versioni Unicode e ANSI su Windows NT.

Vedi anche

Comune di dialogo casella libreria panoramica, funzioni di Box di dialogo comuni, GetOpenFileName, GetSaveFileName

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index