Compartir a través de

Función SHCloneSpecialIDList (shlobj_core.h)

  • Artículo

[SHCloneSpecialIDList está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. En su lugar, use SHGetSpecialFolderLocation.]

Recupera un puntero a la estructura ITEMIDLIST que especifica una carpeta especial.

Sintaxis

PIDLIST_ABSOLUTE SHCloneSpecialIDList(
       HWND hwnd,
  [in] int  csidl,
  [in] BOOL fCreate
);

Parámetros

hwnd

Tipo: HWND

Reservado.

[in] csidl

Tipo: int

Valor CSIDL que identifica la carpeta de interés.

[in] fCreate

Tipo: BOOL

Valor de tipo BOOL que indica si la carpeta debe crearse si aún no existe. Si fCreate es TRUE, se crea la carpeta . Si es FALSE, no se crea la carpeta .

Valor devuelto

Tipo: PIDLIST_ABSOLUTE

Devuelve un puntero a la estructura ITEMIDLIST de una carpeta especial especificada por csidl. La función crea la carpeta si fCreate es TRUE.

Comentarios

Cuando termine, debe liberar el puntero a la carpeta clonada con ILFree.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlobj_core.h (incluya Shlobj.h)
Library Shell32.lib
Archivo DLL Shell32.dll (versión 5.0 o posterior)
Conjunto de API ext-ms-win-shell-shell32-l1-2-2 (introducido en Windows 10, versión 10.0.14393)