Função de retorno de chamada RasCustomDialFn (ras.h)

Artigo
08/25/2023

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

]

A função RasCustomDial é 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 rotinas personalizadas de discagem de acesso remoto.

Sintaxe

RasCustomDialFn Rascustomdialfn;

DWORD Rascustomdialfn(
  HINSTANCE hInstDll,
  LPRASDIALEXTENSIONS lpRasDialExtensions,
  LPCWSTR lpszPhonebook,
  LPRASDIALPARAMS lpRasDialParams,
  DWORD dwNotifierType,
  LPVOID lpvNotifier,
  LPHRASCONN lphRasConn,
  DWORD dwFlags
)
{...}

Parâmetros

hInstDll

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

lpRasDialExtensions

Ponteiro para uma estrutura RASDIALEXTENSIONS que especifica um conjunto de recursos estendidos rasDial a serem habilitados. Defina esse parâmetro como NULL se não houver necessidade de habilitar as extensões.

lpszPhonebook

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o caminho completo e o nome de 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 catálogo 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 .

lpRasDialParams

Ponteiro para uma estrutura RASDIALPARAMS que especifica parâmetros de chamada para a conexão RAS.

O chamador deve definir o membro dwSize da estrutura RASDIALPARAMS como sizeof (RASDIALPARAMS) para identificar a versão da estrutura que está sendo passada.

dwNotifierType

Esse parâmetro é o mesmo que o parâmetro dwNotifierType para a função RasDial . Consulte a página de referência rasDial para obter mais informações.

lpvNotifier

Esse parâmetro é o mesmo que o parâmetro lpvNotifier para a função RasDial . Consulte a página de referência rasDial para obter mais informações.

lphRasConn

Ponteiro para uma variável do tipo HRASCONN. Defina a variável HRASCONN como NULL antes de chamar RasDial. Se RasDial for bem-sucedido, ele armazenará um identificador para a conexão RAS em *lphRasConn.

dwFlags

Esse parâmetro reservado para uso futuro.

Valor retornado

Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS e um identificador para a conexão RAS na variável apontada pelo parâmetro lphRasConn será retornado.

Se a função falhar, o valor retornado será um dos seguintes códigos de erro ou um valor de Códigos de Erro de Roteamento e Acesso Remoto ou Winerror.h.

Valor	Significado
ERROR_NOT_ENOUGH_MEMORY	A função não pôde alocar memória suficiente para concluir a operação.

Comentários

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

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

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

Requisitos


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	ras.h