Função InternetConfirmZoneCrossingW (wininet.h)

Artigo
11/20/2024

Verifica se há alterações entre URLs seguras e não seguras. Sempre informe o usuário quando ocorre uma alteração na segurança entre duas URLs. Normalmente, um aplicativo deve permitir que o usuário reconheça a alteração por meio da interação com uma caixa de diálogo.

Sintaxe

DWORD InternetConfirmZoneCrossingW(
  [in] HWND   hWnd,
  [in] LPWSTR szUrlPrev,
  [in] LPWSTR szUrlNew,
  [in] BOOL   bPost
);

Parâmetros

[in] hWnd

Manipule para a janela pai para qualquer caixa de diálogo necessária.

[in] szUrlPrev

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica a URL que foi exibida antes da solicitação atual ser feita.

[in] szUrlNew

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica a nova URL que o usuário solicitou para exibir.

[in] bPost

Não implementado.

Valor de retorno

Retorna um dos seguintes valores.

Código de retorno	Descrição
ERROR_SUCCESS	O usuário confirmou que não havia problema em continuar ou que não havia nenhuma entrada de usuário necessária.
ERROR_CANCELLED	O usuário cancelou a solicitação.
ERROR_NOT_ENOUGH_MEMORY	Não há memória suficiente para realizar a solicitação.

Observações

Sempre informe o usuário quando ocorre uma alteração no nível de segurança ou você corre o risco de submeter o usuário à divulgação involuntária de informações.

Assim como todos os outros aspectos da API WinINet, essa função não pode ser chamada com segurança de dentro do DllMain ou dos construtores e destruidores de objetos globais.

Observação WinINet não dá suporte a implementações de servidor. Além disso, ele não deve ser usado de um serviço. Para implementações ou serviços de servidor, use do Microsoft Windows HTTP Services (WinHTTP).

Nota

O cabeçalho wininet.h define InternetConfirmZoneCrossing 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. 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 2000 Professional [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	wininet.h
biblioteca	Wininet.lib
de DLL	Wininet.dll

Consulte também

habilitando de funcionalidade da Internet

do WinINet Functions

Compartilhar via