Función PickIconDlg (shlobj_core.h)

[PickIconDlg está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.

Muestra un cuadro de diálogo que permite al usuario elegir un icono de la selección disponible en un recurso, como un archivo ejecutable o DLL.

Sintaxis

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

Parámetros

[in, optional] hwnd

Tipo: HWND

Identificador de la ventana primaria. Este valor puede ser NULL.

[in, out] pszIconPath

Tipo: PWSTR

Puntero a una cadena que contiene la ruta de acceso completa terminada en null del recurso predeterminado que contiene los iconos. Si el usuario elige un recurso diferente en el cuadro de diálogo, este búfer contiene la ruta de acceso de ese archivo cuando la función devuelve. Este búfer debe tener al menos MAX_PATH caracteres de longitud o se puede truncar la ruta de acceso devuelta. Debe comprobar que la ruta de acceso es válida antes de usarla.

cchIconPath

Tipo: UINT

Número de caracteres de pszIconPath, incluido el carácter NULL de terminación.

[in, out, optional] piIconIndex

Tipo: int*

Puntero a un entero que en la entrada especifica el índice de la selección inicial y, cuando esta función vuelve correctamente, recibe el índice del icono seleccionado.

Valor devuelto

Tipo: int

Devuelve 1 si se ejecuta correctamente; de lo contrario, 0.

Requisitos