Função de retorno de chamada RasCustomDialDlgFn (rasdlg.h)

[Essa função não está disponível a partir do Windows Server 2008.

]

A função RasCustomDialDlg é uma função definida pelo aplicativo que é exportada por uma DLL de discagem personalizada de terceiros. Essa função permite que fornecedores de terceiros implementem caixas de diálogo de conexão RAS personalizadas.

Sintaxe

RasCustomDialDlgFn Rascustomdialdlgfn;

BOOL Rascustomdialdlgfn(
  HINSTANCE hInstDll,
  DWORD dwFlags,
  LPWSTR lpszPhonebook,
  LPWSTR lpszEntry,
  LPWSTR lpszPhoneNumber,
  LPRASDIALDLG lpInfo,
  PVOID pvInfo
)
{...}

Parâmetros

hInstDll

Manipule para a instância da DLL de discagem personalizada que foi carregada.

dwFlags

Um conjunto de sinalizadores de bits que especificam opções RasCustomDialDlg .

Valor Significado
RCD_Logon
Se esse sinalizador for definido como um, a conexão foi discada de um contexto de Logon do Windows. RasDial usa essas informações para obter as preferências de usuário apropriadas para a entrada de conexão. Se RasDial for chamado desse ponto de entrada, o membro dwfOptions do parâmetro lpRasDialExtension deverá ter o sinalizador RDEOPT_NoUser definido para indicar que a conexão foi discada de um contexto de Logon do Windows.
 

Windows Server 2003 e Windows XP/2000: Esse parâmetro é reservado e não deve ser usado.

lpszPhonebook

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o caminho completo e o nome do arquivo de um arquivo de catálogo telefônico (PBK). Se esse parâmetro for NULL, a função usará o arquivo de catálogo telefônico padrão atual. O arquivo de agendamento telefônico padrão é aquele selecionado pelo usuário na folha de propriedades Preferências do Usuário da caixa de diálogo Rede Discada .

lpszEntry

Ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome da entrada do catálogo telefônico para discar.

lpszPhoneNumber

Ponteiro para uma cadeia de caracteres terminada em nulo que contém um número de telefone que substitui os números armazenados na entrada do catálogo telefônico. Se esse parâmetro for NULL, RasDialDlg usará os números na entrada do catálogo telefônico.

lpInfo

Ponteiro para uma estrutura RASDIALDLG que contém parâmetros adicionais de entrada e saída. Na entrada, o membro dwSize dessa estrutura deve especificar sizeof( RASDIALDLG). Se ocorrer um erro, o membro dwError retornará um código de erro; caso contrário, ele retornará zero.

pvInfo

Reservado para uso interno. Esse parâmetro sempre será NULL.

Retornar valor

Se o usuário criar, copiar ou editar uma entrada de catálogo telefônico, o valor retornado deverá ser TRUE. Caso contrário, a função deverá retornar FALSE.

Se ocorrer um erro, RasCustomEntryDlg deverá definir o membro dwError da estrutura RASENTRYDLG como um valor de Códigos de Erro de Roteamento e Acesso Remoto ou Winerror.h.

Comentários

RAS chama esse ponto de entrada de RasDialDlg, se o membro szCustomDialDll da estrutura RASENTRY para a entrada que está sendo discada especifica uma DLL de discagem personalizada.

Se esse ponto de entrada chamar RasDial, o parâmetro lpRasDialExtensions não deverá ser NULL e o membro dwfOptions da estrutura RASDIALEXTENSIONS deverá ter o sinalizador RDEOPT_CustomDial definido.

A caixa de diálogo de discagem personalizada deve dar suporte a mensagens WM_COMMAND em que LOWORD(wParam) é igual a IDCANCEL.

Se a DLL de discagem personalizada não der suporte a esse ponto de entrada, RAS retornará ERROR_CANNOT_DO_CUSTOMDIAL ao chamador de RasDialDlg.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [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 rasdlg.h

Confira também

Discadores personalizados

RASENTRY

RasCustomDial

RasCustomEntryDlg

RasCustomHangUp

RasDialDlg

Visão geral do RAS (Serviço de Acesso Remoto)

Funções do serviço de acesso remoto