Función OleMetafilePictFromIconAndLabel (ole2.h)
Crea un metarchivo en el que se dibuja el icono y la etiqueta especificados.
Sintaxis
HGLOBAL OleMetafilePictFromIconAndLabel(
[in] HICON hIcon,
[in] LPOLESTR lpszLabel,
[in] LPOLESTR lpszSourceFile,
[in] UINT iIconIndex
);
Parámetros
[in] hIcon
Identificador del icono que se va a dibujar en el metarchivo. Este parámetro puede ser NULL. Si hIcon es NULL, esta función devuelve NULL sin crear un metarchivo.
[in] lpszLabel
Etiqueta de icono. Este parámetro puede ser NULL. Si lpszLabel es NULL, el metarchivo resultante no incluirá una etiqueta.
[in] lpszSourceFile
Ruta de acceso y nombre de archivo del archivo de icono. Esta cadena se puede obtener a través de la interfaz de usuario o de la base de datos de registro. Este parámetro puede ser NULL.
[in] iIconIndex
Ubicación del icono dentro del archivo denominado por lpszSourceFile, expresado como desplazamiento en bytes desde el principio del archivo.
Valor devuelto
Identificador global de una estructura METAFILEPICT que contiene el icono y la etiqueta. El metarchivo usa el modo de asignación de MM_ANISOTROPIC.
Si se produce un error, el identificador devuelto es NULL. En este caso, el autor de la llamada puede llamar a GetLastError para obtener más información.
Comentarios
OleGetIconOfFile llama a esta función y OleGetIconOfClass.
Si lpszSourceFile no es NULL y iIconIndex no es 0, el nombre del archivo de origen pasado en lpszSourceFile y el índice pasado por iIconIndex se agrega al metarchivo creado como registro de comentario.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | ole2.h |
| Library | Ole32.lib |
| Archivo DLL | Ole32.dll |