PickIconDlg-Funktion (shlobj_core.h)

  • Artikel

[PickIconDlg ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Zeigt ein Dialogfeld an, mit dem der Benutzer ein Symbol aus der Auswahl auswählen kann, die in eine Ressource eingebettet ist, z. B. eine ausführbare Datei oder eine DLL-Datei.

Syntax

int PickIconDlg(
  [in, optional]      HWND  hwnd,
  [in, out]           PWSTR pszIconPath,
                      UINT  cchIconPath,
  [in, out, optional] int   *piIconIndex
);

Parameter

[in, optional] hwnd

Typ: HWND

Das Handle des übergeordneten Fensters. Dieser Wert kann NULL sein.

[in, out] pszIconPath

Typ: PWSTR

Ein Zeiger auf eine Zeichenfolge, die den null-beendeten, vollqualifizierten Pfad der Standardressource enthält, die die Symbole enthält. Wenn der Benutzer eine andere Ressource im Dialogfeld auswäht, enthält dieser Puffer den Pfad dieser Datei, wenn die Funktion zurückgibt. Dieser Puffer sollte mindestens MAX_PATH Zeichen lang sein, oder der zurückgegebene Pfad kann abgeschnitten werden. Sie sollten überprüfen, ob der Pfad gültig ist, bevor Sie ihn verwenden.

cchIconPath

Typ: UINT

Die Anzahl der Zeichen in pszIconPath, einschließlich des beendenden NULL-Zeichens .

[in, out, optional] piIconIndex

Typ: int*

Ein Zeiger auf eine ganze Zahl, die bei einem Eintrag den Index der ersten Auswahl angibt und bei erfolgreicher Rückgabe dieser Funktion den Index des ausgewählten Symbols empfängt.

Rückgabewert

Typ: int

Gibt bei erfolgreicher Ausführung 1 zurück. andernfalls 0.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlobj_core.h (einschließlich Shlobj.h)
Bibliothek Shell32.lib
DLL Shell32.dll (Version 6.0 oder höher)
APIs ext-ms-win-shell-shell32-l1-2-1 (eingeführt in Windows 10, Version 10.0.10240)