Función URLAssociationDialogA (intshcut.h)

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 de

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 de

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 de

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

[out] pszAppBuf

Tipo: PTSTR de

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 compatibles, 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.

Observaciones

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