Función MIMEAssociationDialogA (intshcut.h)

Artículo
11/20/2024

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 de

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 especificado. 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 de

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 está asociada 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.

Observaciones

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 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	intshcut.h
DLL de	Url.dll

Compartir a través de