Método IDsDisplaySpecifier::GetIconLocation (dsclient.h)
El método IDsDisplaySpecifier::GetIconLocation obtiene la ubicación del icono de una clase de objeto determinada. La ubicación del icono incluye el nombre de archivo y el identificador de recursos.
Sintaxis
HRESULT GetIconLocation(
[in] LPCWSTR pszObjectClass,
[in] DWORD dwFlags,
[in, out] LPWSTR pszBuffer,
[in] INT cchBuffer,
[in, out] INT *presid
);
Parámetros
[in] pszObjectClass
Puntero a una cadena Unicode terminada en null que contiene el nombre de la clase de objeto para la que se va a obtener la ubicación del 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 siguientes elementos.
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_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 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, este método devuelve NULL.
[in, out] pszBuffer
Puntero a un búfer de caracteres anchos que recibe la ruta de acceso y el nombre de archivo del archivo que contiene el icono. Este búfer debe tener al menos caracteres anchos de cchBuffer de longitud.
[in] cchBuffer
Contiene el tamaño del búfer pszBuffer , en caracteres anchos, incluido el carácter NULL de terminación. Si el nombre de archivo supera este número de caracteres, el nombre de archivo se trunca.
[in, out] presid
Puntero a un valor INT que recibe el identificador de recurso o el índice del icono. Si este valor es positivo, el valor es el índice del icono del archivo. Si este valor es negativo, el valor absoluto de este valor es el identificador de recurso del icono del archivo.
Valor devuelto
Devuelve un valor HRESULT estándar, incluido lo siguiente.
Requisitos
| Requisito | Value |
|---|---|
| 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