Função URLAssociationDialogA (intshcut.h)

  • Artigo

Invoca a caixa de diálogo protocolo URL não registrado. Essa caixa de diálogo permite que o usuário selecione um aplicativo para associar a um protocolo até então desconhecido.

Nota Windows XP Service Pack 2 (SP2) ou posterior: essa função não tem mais suporte.
 

Sintaxe

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

Parâmetros

hwndParent

Digite: HWND

Um identificador para a janela pai.

dwInFlags

Tipo: DWORD

Os sinalizadores de bit que especificam o comportamento da função. Esse valor pode ser uma combinação do seguinte:

URLASSOCDLG_FL_USE_DEFAULT_NAME

Use o nome de arquivo padrão (ou seja, "Atalho da Internet").

URLASSOCDLG_FL_REGISTER_ASSOC

Registre o aplicativo selecionado como o manipulador do protocolo especificado em pcszURL. O aplicativo será registrado somente se esse sinalizador estiver definido e o usuário indicar que uma associação persistente será desejada.

pcszFile

Tipo: PTCSTR

O endereço de uma cadeia de caracteres terminada zero constante que contém o nome do arquivo a ser associado ao protocolo de URLs.

pcszURL

Tipo: PTCSTR

O endereço de uma cadeia de caracteres terminada por zero constante que contém a URL com um protocolo desconhecido.

[out] pszAppBuf

Tipo: PTSTR

O endereço de um buffer que recebe o caminho do aplicativo especificado pelo usuário.

ucAppBufLen

Tipo: UINT

O tamanho do pszAppBuf, em caracteres.

Retornar valor

Tipo: HRESULT

Nota A partir do Windows XP SP2, essa função não tem suporte e retorna E_NOTIMPL em todas as situações.
 
Em sistemas com suporte, retorna S_OK se o aplicativo estiver registrado com o protocolo de URL ou S_FALSE se nada for registrado. Por exemplo, a função retorna S_FALSE quando o usuário opta por executar uma execução única por meio do aplicativo selecionado.

Comentários

Observação

O cabeçalho intshcut.h define URLAssociationDialog como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho intshcut.h
DLL Url.dll