Condividi tramite


Funzione PathParseIconLocationA (shlwapi.h)

Analizza una stringa di percorso del file che contiene un percorso di file e un indice icona e restituisce valori separati.

Sintassi

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

Parametri

[in, out] pszIconFile

Tipo: LPTSTR

Puntatore a una stringa di lunghezza con terminazione Null MAX_PATH che contiene una stringa di percorso del file. Deve essere nel formato " percorso, iconaindex". Quando la funzione viene restituita, pszIconFile punterà al percorso del file.

Valore restituito

Tipo: int

Restituisce il valore di indice dell'icona valido.

Osservazioni

Questa funzione è utile per accettare un valore DefaultIcon recuperato dal Registro di sistema SHGetValue e separare l'indice dell'icona dal percorso.

Esempi

#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

Nota

L'intestazione shlwapi.h definisce PathParseIconLocation come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito Valore
client minimo supportato Windows 2000 Professional, Windows XP [solo app desktop]
server minimo supportato Windows 2000 Server [solo app desktop]
piattaforma di destinazione Finestre
intestazione shlwapi.h
libreria Shlwapi.lib
dll Shlwapi.dll (versione 4.71 o successiva)