Share via

Función URLAssociationDialogA (intshcut.h)

  • Artículo

Invoca el cuadro de diálogo protocolo de dirección URL no registrado. Este cuadro de diálogo permite al usuario seleccionar una aplicación para asociarla a un protocolo desconocido anteriormente.

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

Sintaxis

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

Parámetros

hwndParent

Tipo: HWND

Identificador de la ventana primaria.

dwInFlags

Tipo: DWORD

Marcas de bits que especifican el comportamiento de la función. Este valor puede ser una combinación de lo siguiente:

URLASSOCDLG_FL_USE_DEFAULT_NAME

Use el nombre de archivo predeterminado (es decir, "Acceso directo a Internet").

URLASSOCDLG_FL_REGISTER_ASSOC

Registre la aplicación seleccionada como controlador para el protocolo especificado en pcszURL. La aplicación solo se registra si se establece esta marca y el usuario indica que se desea una asociación persistente.

pcszFile

Tipo: PTCSTR

Dirección de una cadena de terminación cero constante que contiene el nombre de archivo que se va a asociar al protocolo de direcciones URL.

pcszURL

Tipo: PTCSTR

Dirección de una cadena constante terminada en cero que contiene la dirección URL con un protocolo desconocido.

[out] pszAppBuf

Tipo: PTSTR

Dirección de un búfer que 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 la aplicación está registrada con el protocolo de dirección URL o S_FALSE si no se registra nada. Por ejemplo, la función devuelve S_FALSE cuando el usuario elige realizar una ejecución única a través de la aplicación seleccionada.

Comentarios

Nota

El encabezado intshcut.h define URLAssociationDialog 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