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
| 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 (incluya Shobjidl.h) |
| Archivo DLL | Shell32.dll (versión 4.0 o posterior) |