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