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

Inicializa una extensión de hoja de propiedades, una extensión de menú contextual o un controlador de arrastrar y colocar.

Sintaxis

HRESULT Initialize(
  [in] PCIDLIST_ABSOLUTE pidlFolder,
  [in] IDataObject       *pdtobj,
  [in] HKEY              hkeyProgID
);

Parámetros

[in] pidlFolder

Tipo: PCIDLIST_ABSOLUTE

Puntero a una estructura ITEMIDLIST que identifica de forma única una carpeta. Para las extensiones de hoja de propiedades, este parámetro es NULL. Para las extensiones de menú contextual, es la lista de identificadores de elemento de la carpeta que contiene el elemento cuyo menú contextual se muestra. Para las extensiones de menú de arrastrar y colocar no predeterminadas, este parámetro especifica la carpeta de destino.

[in] pdtobj

Tipo: IDataObject*

Puntero a un objeto de interfaz IDataObject que se puede usar para recuperar los objetos en los que se actúa.

[in] hkeyProgID

Tipo: HKEY

Clave del Registro para el tipo de carpeta o objeto de archivo.

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

Los significados de algunos parámetros dependen del tipo de extensión. En el caso de los controladores de arrastrar y colocar, el parámetro pidlFolder especifica la carpeta de destino (destino de colocación), el parámetro pdtobj identifica los elementos que se quitan y el parámetro hkeyProgID especifica el tipo de archivo de la carpeta de destino.

Para las extensiones de menú contextual, pdtobj identifica los objetos de archivo seleccionados, hkeyProgID identifica el tipo de archivo del objeto con foco y pidlFolder es NULL (para objetos de archivo) o especifica la carpeta para la que se solicita el menú contextual (para los menús contextuales de fondo de carpetas).

Para las extensiones de hoja de propiedades, pidlFolder es NULL, pdtobj identifica los objetos de archivo seleccionados y hkeyProgID especifica el tipo de archivo del objeto de archivo que tiene el foco.

Notas para los implementadores

Este es el primer método al que el Shell llama después de crear una instancia de una extensión de hoja de propiedades, una extensión de menú contextual o un controlador de arrastrar y colocar.

Requisitos

Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shobjidl_core.h (include Shobjidl.h)
Archivo DLL	Shell32.dll (versión 4.0 o posterior)