Método IDsDisplaySpecifier::GetIcon (dsclient.h)
El método IDsDisplaySpecifier::GetIcon obtiene el icono de una clase de objeto determinada.
Sintaxis
HICON GetIcon(
[in] LPCWSTR pszObjectClass,
[in] DWORD dwFlags,
[in] INT cxIcon,
[in] INT cyIcon
);
Parámetros
[in] pszObjectClass
Puntero a una cadena Unicode terminada en null que contiene el nombre de la clase de objeto para la que obtener el icono. Algunos ejemplos del nombre de la clase de objeto son "user" y "container".
[in] dwFlags
Contiene un conjunto de marcas que indican el tipo de icono que se va a recuperar. Puede ser una combinación de uno o varios de los valores siguientes.
DSGIF_ISNORMAL
Obtiene el icono normal de la clase de objeto.
DSGIF_ISOPEN
Obtiene el icono de apertura, como una carpeta abierta, para la clase de objeto. Si la clase de objeto no tiene un icono abierto, este método intenta obtener el icono normal de la clase de objeto.
DSGIF_ISDISABLED
Obtiene el icono deshabilitado, como un usuario deshabilitado, para la clase de objeto. Si la clase de objeto no tiene un icono deshabilitado, este método intenta obtener el icono normal de la clase de objeto.
DSGIF_ISMASK
Se usa para enmascarar las marcas de DSGIF_ISNORMAL, DSGIF_ISOPEN y DSGIF_ISDISABLED .
DSGIF_GETDEFAULTICON
Si no se encuentra ningún icono para la clase de objeto, este método devuelve un icono predeterminado. Si no se especifica esta marca y no se puede encontrar ningún icono para la clase de objeto, este método devuelve NULL.
DSGIF_DEFAULTISCONTAINER
Si no se encuentra ningún icono para la clase de objeto, este método devolverá el icono de contenedor como icono predeterminado. Si no se especifica esta marca y no se puede encontrar ningún icono para la clase de objeto, este método devuelve NULL.
[in] cxIcon
Contiene el ancho deseado, en píxeles, del icono. Este método obtiene el icono que coincide más estrechamente con este ancho.
[in] cyIcon
Contiene el alto deseado, en píxeles, del icono. Este método obtiene el icono que coincide más estrechamente con este alto.
Valor devuelto
Devuelve un identificador al icono, si se ejecuta correctamente, o NULL de lo contrario. El autor de la llamada debe destruir este icono cuando ya no sea necesario pasando este identificador a DestroyIcon.
Requisitos
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | dsclient.h |
| Archivo DLL | Dsadmin.dll |
Consulte también
Mostrar interfaces en Servicios de dominio de Active Directory