Función SHCreateDataObject (shlobj_core.h)

Crea un objeto de datos en una carpeta primaria.

Sintaxis

SHSTDAPI SHCreateDataObject(
  [in, optional] PCIDLIST_ABSOLUTE     pidlFolder,
  [in]           UINT                  cidl,
  [in, optional] PCUITEMID_CHILD_ARRAY apidl,
  [in, optional] IDataObject           *pdtInner,
  [in]           REFIID                riid,
  [out]          void                  **ppv
);

Parámetros

[in, optional] pidlFolder

Tipo: PCIDLIST_ABSOLUTE

Puntero a un ITEMIDLIST (PIDL) de la carpeta primaria que contiene el objeto de datos.

[in] cidl

Tipo: UINT

Número de objetos de archivo o subcarpetas especificados en el parámetro apidl .

[in, optional] apidl

Tipo: PCUITEMID_CHILD_ARRAY

Matriz de punteros a estructuras ITEMIDLIST constantes, cada una de las cuales identifica de forma única un objeto de archivo o subcarpeta en relación con la carpeta primaria. Cada lista de identificadores de elemento debe contener exactamente una estructura SHITEMID seguida de un terminación cero.

[in, optional] pdtInner

Tipo: IDataObject*

Puntero a la interfaz IDataObject. Este parámetro puede ser NULL. Especifique pdtInner solo si el objeto de datos creado necesita admitir formatos de Portapapeles FORMATETC adicionales más allá de los formatos predeterminados que se asignan al crear. Como alternativa, proporcione compatibilidad para rellenar el objeto de datos creado mediante formatos de Portapapeles no predeterminados llamando al método IDataObject::SetData y especificando el formato en la estructura FORMATETC pasada en el parámetro pFormatetc.

[in] riid

Tipo: REFIID

Referencia al IID de la interfaz que se va a recuperar a través de ppv. Debe ser IID_IDataObject.

[out] ppv

Tipo: void**

Cuando este método vuelve correctamente, contiene el puntero de interfaz IDataObject solicitado en riid.

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Normalmente, se llama a esta función al implementar el método IShellFolder::GetUIObjectOf. Cuando se solicita un puntero de interfaz del identificador de interfaz IID_IDataObject (mediante el parámetro riid), el implementador puede devolver el puntero de interfaz en el objeto creado con SHCreateDataObject en respuesta.

Esta función admite el formato de portapapeles de CFSTR_SHELLIDLIST (también conocido como HIDA) y también tiene compatibilidad genérica con formatos arbitrarios del Portapapeles a través de IDataObject::SetData. Para obtener más información sobre los formatos del Portapapeles, consulte Formatos del Portapapeles de Shell.

El nuevo objeto de datos está pensado para usarse en operaciones como arrastrar y colocar, en las que los datos se almacenan en el Portapapeles con un formato determinado.

Se recomienda usar la macro IID_PPV_ARGS , definida en Objbase.h, para empaquetar los parámetros riid y ppv . Esta macro proporciona el IID correcto basado en la interfaz a la que apunta el valor en ppv, lo que elimina la posibilidad de un error de codificación en riid que podría dar lugar a resultados inesperados.

Requisitos

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

Consulte también

CIDLData_CreateFromIDArray