Compartir a través de

Función SHGetAttributesFromDataObject (shlobj_core.h)

  • Artículo

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

Recupera fragmentos de información especificados de un objeto de datos del sistema.

Sintaxis

HRESULT SHGetAttributesFromDataObject(
  [in, optional]  IDataObject *pdo,
                  DWORD       dwAttributeMask,
  [out, optional] DWORD       *pdwAttributes,
  [out, optional] UINT        *pcItems
);

Parámetros

[in, optional] pdo

Tipo: IDataObject*

Objeto de datos desde el que se va a recuperar la información.

dwAttributeMask

Tipo: DWORD

Una o varias de las marcas SFGAO que indican qué fragmentos de información quiere recuperar la aplicación que llama.

[out, optional] pdwAttributes

Tipo: DWORD*

Puntero a un valor DWORD que, cuando esta función devuelve correctamente, recibe una o varias marcas SFGAO que indican los atributos, entre los solicitados, que son comunes a todos los elementos de pdo. Este puntero puede ser NULL si esta información no es necesaria.

[out, optional] pcItems

Tipo: UINT*

Puntero a un UINT que, cuando esta función devuelve correctamente, recibe el número de PIN en el objeto de datos al que apunta pdo. Este puntero puede ser NULL si esta información no es necesaria.

Valor devuelto

Tipo: HRESULT

Esta función puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 Correcto.
S_FALSE
 El objeto no es un objeto de datos del sistema. En este caso, pdwAttributes se establece en 0.

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 6.0 o posterior)