Función DsGetIcon (dsclient.h)

La función DsGetIcon obtiene el icono de una clase de objeto determinada. Esta función está obsoleta. Las nuevas aplicaciones deben usar el método IDsDisplaySpecifier::GetIcon para realizar esta función.

Sintaxis

HICON DsGetIcon(
  [in] DWORD   dwFlags,
  [in] LPCWSTR pszObjectClass,
  [in] INT     cxImage,
  [in] INT     cyImage
);

Parámetros

[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, esta función 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, esta función intenta obtener el icono normal de la clase de objeto.

DSGIF_GETDEFAULTICON

Si no se encuentra ningún icono para la clase de objeto, esta función devolverá un icono predeterminado. Si no se especifica esta marca y no se puede encontrar ningún icono para la clase de objeto, esta función devuelve NULL.

DSGIF_DEFAULTISCONTAINER

Si no se encuentra ningún icono para la clase de objeto, esta función devuelve 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, esta función devuelve NULL.

[in] pszObjectClass

Puntero a una cadena Unicode terminada en null que contiene el nombre de la clase de objeto para la que recuperar el icono. Algunos ejemplos del nombre de la clase de objeto son "user" y "container".

[in] cxImage

Contiene el ancho deseado, en píxeles, del icono. Esta función recupera el icono que coincide más estrechamente con este ancho.

[in] cyImage

Contiene el alto deseado, en píxeles, del icono. Esta función recupera el icono que coincide más estrechamente con este alto.

Valor devuelto

Devuelve un identificador al icono si es correcto 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

Consulte también

Destroyicon

IDsDisplaySpecifier::GetIcon