Função PathParseIconLocationA (shlwapi.h)
Analisa uma cadeia de caracteres de local do arquivo que contém um local de arquivo e um índice de ícone e retorna valores separados.
Sintaxe
int PathParseIconLocationA(
[in, out] LPSTR pszIconFile
);
Parâmetros
[in, out] pszIconFile
Tipo: LPTSTR
Um ponteiro para uma cadeia de caracteres terminada em nulo de comprimento MAX_PATH que contém uma cadeia de caracteres de local do arquivo. Ele deve estar no formato "path,iconindex". Quando a função retornar, pszIconFile apontará para o caminho do arquivo.
Retornar valor
Tipo: int
Retorna o valor de índice de ícone válido.
Comentários
Essa função é útil para pegar um valor DefaultIcon recuperado do registro por SHGetValue e separar o índice de ícone do caminho.
Exemplos
#include <windows.h>
#include <iostream.h>
#include "Shlwapi.h"
void main(void)
{
// Path to parse for file and icon index.
char buffer_1[ ] = "C:\\TEST\\sample.txt,3";
char *lpStr1;
lpStr1 = buffer_1;
// Return value from "PathParseIconLocation".
int retval;
// Search a path to parse for file and icon index.
retval = PathParseIconLocation(lpStr1);
cout << "The path to parse for file and icon index is : " << lpStr1 << endl;
cout << "PathParseIconLocation returns the icon index of: " << retval << endl;
}
OUTPUT:
==========
The path to parse for file and icon index is : C:\TEST\sample.txt
PathParseIconLocation returns the icon index of: 3
Observação
O cabeçalho shlwapi.h define PathParseIconLocation 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, Windows XP [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 | shlwapi.h |
Biblioteca | Shlwapi.lib |
DLL | Shlwapi.dll (versão 4.71 ou posterior) |
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de