Método IShellFolder::GetAttributesOf (shobjidl_core.h)

Obtiene los atributos de uno o varios objetos de archivo o carpeta contenidos en el objeto representado por IShellFolder.

Sintaxis

HRESULT GetAttributesOf(
  [in]      UINT                  cidl,
  [in]      PCUITEMID_CHILD_ARRAY apidl,
  [in, out] SFGAOF                *rgfInOut
);

Parámetros

[in] cidl

Tipo: UINT

Número de elementos de los que se van a recuperar los atributos.

[in] apidl

Tipo: PCUITEMID_CHILD_ARRAY*

Dirección de una matriz de punteros a estructuras ITEMIDLIST , cada una de las cuales identifica de forma única un elemento relativo a la carpeta primaria. Cada estructura ITEMIDLIST debe contener exactamente una estructura SHITEMID seguida de un cero de terminación.

[in, out] rgfInOut

Tipo: SFGAOF*

Puntero a un único valor de ULONG que, en la entrada, contiene los atributos SFGAO bit a bit que solicita la aplicación que realiza la llamada. Al salir, este valor contiene los atributos solicitados que son comunes a todos los elementos especificados.

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

Para optimizar esta operación, no devuelva marcas no especificadas.

En el caso de un objeto folder, el atributo SFGAO_BROWSABLE implica que el cliente puede enlazar a este objeto como se muestra en un formulario general aquí.

IShellFolder::BindToObject(..., pidl, IID_IShellFolder, &psfItem);

A continuación, el cliente puede crear un IShellView en ese elemento a través de esta instrucción.

psfItem->CreateViewObject(..., IID_IShellView,...);

El atributo SFGAO_DROPTARGET implica que el cliente puede enlazar a una instancia de IDropTarget para esta carpeta llamando a IShellFolder::GetUIObjectOf como se muestra aquí.

IShellFolder::GetUIObjectOf(hwnd, 1, &pidl, IID_IDropTarget, NULL, &pv)

El atributo SFGAO_NONENUMERATED indica un elemento que no devuelve el enumerador creado por el método IShellFolder::EnumObjects .

Requisitos

Consulte también

IShellFolder

IShellFolder2