Función PathParseIconLocationA (shlwapi.h)

Analiza una cadena de ubicación de archivo que contiene una ubicación de archivo y un índice de icono, y devuelve valores independientes.

Sintaxis

int PathParseIconLocationA(
  [in, out] LPSTR pszIconFile
);

Parámetros

[in, out] pszIconFile

Tipo: LPTSTR

Puntero a una cadena terminada en null de longitud MAX_PATH que contiene una cadena de ubicación de archivo. Debe tener el formato "path,iconindex". Cuando se devuelve la función, pszIconFile apuntará a la ruta de acceso del archivo.

Valor devuelto

Tipo: int

Devuelve el valor de índice de icono válido.

Comentarios

Esta función es útil para tomar un valor DefaultIcon recuperado del Registro por SHGetValue y separar el índice de icono de la ruta de acceso.

Ejemplos

#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

Requisitos