Método IPersistFolder::Initialize (shobjidl_core.h)

Indica a un objeto de carpeta de Shell que se inicialice en función de la información pasada.

Sintaxis

HRESULT Initialize(
  PCIDLIST_ABSOLUTE pidl
);

Parámetros

pidl

Tipo: LPCITEMIDLIST

Dirección de la estructura ITEMIDLIST (lista de identificadores de elemento) que especifica la ubicación absoluta de la carpeta.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Todos los objetos que implementan la interfaz IShellFolder para su uso en el espacio de nombres del Shell deben implementar este método. Cuando la ubicación de una carpeta en el espacio de nombres no es una consideración relevante, este método simplemente puede devolver S_OK. Cuando la ubicación sea relevante para la carpeta, debe almacenar el IDLIST completo pasado para una referencia posterior.

Por ejemplo, si la implementación de la carpeta necesita construir un puntero completo a una lista de identificadores de elemento (PIDL) a los elementos que contiene, se debe usar el PIDL pasado a este método para construir las PIDL completas.

Requisitos