Função GetFileTitleA (commdlg.h)
Recupera o nome do arquivo especificado.
Sintaxe
short GetFileTitleA(
[in] LPCSTR unnamedParam1,
[out] LPSTR Buf,
[in] WORD cchSize
);
Parâmetros
[in] unnamedParam1
Tipo: LPCTSTR
O nome e o local de um arquivo.
[out] Buf
Tipo: LPTSTR
O buffer que recebe o nome do arquivo.
[in] cchSize
Tipo: WORD
O comprimento, em caracteres, do buffer apontado pelo parâmetro lpszTitle .
Retornar valor
Tipo: short
Se a função obtiver êxito, o valor retornado será zero.
Se o nome do arquivo for inválido, o valor retornado será desconhecido. Se houver um erro, o valor retornado será um número negativo.
Se o buffer apontado pelo parâmetro lpszTitle for muito pequeno, o valor retornado será um inteiro positivo que especifica o tamanho do buffer necessário, em caracteres. O tamanho do buffer necessário inclui o caractere nulo de terminação.
Comentários
GetFileTitle só deve ser chamado com nomes de arquivo legais; usar um nome de arquivo inválido tem um resultado indefinido.
Para obter o tamanho do buffer necessário para o nome de um arquivo, chame a função com lpszTitle definido como NULL e cchSize definido como zero. A função retorna o tamanho necessário.
GetFileTitle retorna a cadeia de caracteres que o sistema usaria para exibir o nome do arquivo para o usuário. O nome de exibição incluirá uma extensão somente se essa for a preferência do usuário para exibir nomes de arquivo. Isso significa que a cadeia de caracteres retornada pode não identificar com precisão o arquivo se ele for usado em chamadas para funções do sistema de arquivos.
Se o buffer lpszTitle for muito pequeno, GetFileTitle retornará o tamanho necessário para manter o nome de exibição. No entanto, não há nenhuma relação garantida entre o tamanho necessário e os caracteres originalmente especificados no buffer lpszFile . Por exemplo, não chame GetFileTitle com lpszTitle definido como NULL e cchSize definido como zero e tente usar o valor retornado como um índice na cadeia de caracteres lpszFile . Normalmente, você pode obter resultados semelhantes (e desempenho superior) com funções de biblioteca em tempo de execução C, como strrchr, wcsrchr e _mbsrchr.
Observação
O cabeçalho commdlg.h define GetFileTitle como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | commdlg.h (inclua Windows.h) |
Biblioteca | Comdlg32.lib |
DLL | Comdlg32.dll |
Conjunto de APIs | ext-ms-win-shell-comdlg32-l1-1-1 (introduzido no Windows 10, versão 10.0.14393) |
Confira também
Biblioteca de caixas de diálogo comuns
Conceitual
Referência