Función MIMEAssociationDialogW (intshcut.h)

  • Artículo

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 MIMEAssociationDialogW(
        HWND   hwndParent,
        DWORD  dwInFlags,
        PCWSTR pcszFile,
        PCWSTR pcszMIMEContentType,
  [out] PWSTR  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 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

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 suficiente memoria 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 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 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