Função PathParseIconLocationW (shlwapi.h)

Analisa uma cadeia de caracteres de localização de arquivo que contém um local de arquivo e um índice de ícone e retorna valores separados.

Sintaxe

int PathParseIconLocationW(
  [in, out] LPWSTR pszIconFile
);

Parâmetros

[in, out] pszIconFile

Tipo: LPTSTR

Um ponteiro para uma cadeia de caracteres de comprimento terminada em nulo 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 obter 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)