Función MIMEAssociationDialogA (intshcut.h)

Ejecuta el cuadro de diálogo tipo de contenido MIME no registrado.

Nota Windows XP Service Pack 2 (SP2) o posterior: esta función ya no se admite.

 

Sintaxis

INTSHCUTAPI HRESULT MIMEAssociationDialogA(
        HWND  hwndParent,
        DWORD dwInFlags,
        PCSTR pcszFile,
        PCSTR pcszMIMEContentType,
  [out] PSTR  pszAppBuf,
        UINT  ucAppBufLen
);

Parámetros

hwndParent

Tipo: HWND

Identificador de la ventana primaria de las ventanas secundarias publicadas.

dwInFlags

Tipo: DWORD

Valor de marca de bits que especifica si se va a registrar una asociación. La marca de bits es el valor MIMEASSOCDLG_FL_REGISTER_ASSOC (0x0001). Si se establece este bit, la aplicación seleccionada se registra como controlador para el tipo MIME determinado. Si este bit está claro, no se registra ninguna asociación.

Una aplicación solo se registra si se establece esta marca y el usuario indica que se va a realizar una asociación persistente.

El registro es imposible si la cadena de pcszFile no contiene una extensión.

pcszFile

Tipo: PCTSTR

Dirección de una cadena terminada en null que contiene el nombre del archivo de destino. Este archivo debe cumplir el tipo de contenido descrito por el parámetro pcszMIMEContentType .

pcszMIMEContentType

Tipo: PCTSTR

Dirección de una cadena terminada en null que contiene el tipo de contenido no registrado.

[out] pszAppBuf

Tipo: PTSTR

Puntero a un búfer que, cuando esta función vuelve correctamente, recibe la ruta de acceso de la aplicación especificada por el usuario.

ucAppBufLen

Tipo: UINT

Tamaño de pszAppBuf, en caracteres.

Valor devuelto

Tipo: HRESULT

Nota A partir de Windows XP SP2, esta función no se admite y devuelve E_NOTIMPL en todas las situaciones.

 

En los sistemas admitidos, devuelve S_OK si el tipo de contenido se ha asociado correctamente a la extensión. En este caso, la extensión se asocia como valor predeterminado para el tipo de contenido y pszAppBuf apunta a la cadena que contiene la ruta de acceso de la aplicación especificada. La función devuelve S_FALSE si no se registró nada. De lo contrario, el valor devuelto será uno de los siguientes:

Código devuelto	Descripción
E_ABORT	El usuario canceló la operación.
E_FLAGS	La combinación de marcas pasada en dwInFlags no es válida.
E_OUTOFMEMORY	No había memoria suficiente disponible para completar la operación.
E_POINTER	Uno de los punteros de entrada no es válido.

Comentarios

Esta función no valida la sintaxis de la cadena de tipo de contenido de entrada en pcszMIMEContentType. Un valor devuelto correcto no indica que el tipo de contenido MIME especificado es válido.

Nota

El encabezado intshcut.h define MIMEAssociationDialog como un alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
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	intshcut.h
Archivo DLL	Url.dll