PathParseIconLocationA-Funktion (shlwapi.h)

Artikel
03/04/2024

Analysiert eine Dateispeicherortzeichenfolge, die einen Dateispeicherort und symbolindex enthält, und gibt separate Werte zurück.

Syntax

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

Parameter

[in, out] pszIconFile

Typ: LPTSTR

Ein Zeiger auf eine null-beendete Zeichenfolge der Länge MAX_PATH, die eine Dateispeicherortzeichenfolge enthält. Es sollte die Form "path,iconindex" haben. Wenn die Funktion zurückgegeben wird, zeigt pszIconFile auf den Pfad der Datei.

Rückgabewert

Typ: int

Gibt den gültigen Symbolindexwert zurück.

Hinweise

Diese Funktion ist nützlich, um einen DefaultIcon-Wert zu verwenden, der von SHGetValue aus der Registrierung abgerufen wurde, und um den Symbolindex vom Pfad zu trennen.

Beispiele

#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

Hinweis

Der shlwapi.h-Header definiert PathParseIconLocation als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlwapi.h
Bibliothek	Shlwapi.lib
DLL	Shlwapi.dll (Version 4.71 oder höher)

Freigeben über