Função URLAssociationDialogW (intshcut.h)

Artigo
11/20/2024

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 desconhecido anteriormente.

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

Sintaxe

INTSHCUTAPI HRESULT URLAssociationDialogW(
        HWND   hwndParent,
        DWORD  dwInFlags,
        PCWSTR pcszFile,
        PCWSTR pcszURL,
  [out] PWSTR  pszAppBuf,
        UINT   ucAppBufLen
);

Parâmetros

hwndParent

Tipo: 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 do 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 URLs.

pcszURL

Tipo: PTCSTR

O endereço de uma cadeia de caracteres terminada 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 de pszAppBuf, em caracteres.

Valor de retorno

Tipo: HRESULT

Observação 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 estiver 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.

Observações

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

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

Compartilhar via