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

Artigo
08/25/2023

A função RasCustomEntryDlg é 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 personalizadas para gerenciar entradas de catálogo telefônico.

Sintaxe

RasCustomEntryDlgFn Rascustomentrydlgfn;

BOOL Rascustomentrydlgfn(
  HINSTANCE hInstDll,
  LPWSTR lpszPhonebook,
  LPWSTR lpszEntry,
  LPRASENTRYDLG lpInfo,
  DWORD dwFlags
)
{...}

Parâmetros

hInstDll

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

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 editar, copiar ou criar.

Se você estiver editando ou copiando uma entrada, esse parâmetro será o nome de uma entrada de catálogo telefônico existente. Se você estiver copiando uma entrada, defina o sinalizador RASEDFLAG_CloneEntry no membro dwFlags da estrutura RASENTRYDLG .

Se você estiver criando uma entrada, esse parâmetro será um novo nome de entrada padrão que o usuário pode alterar. Se esse parâmetro for NULL, a função fornecerá um nome padrão. Se você estiver criando uma entrada, defina o sinalizador RASEDFLAG_NewEntry no membro dwFlags da estrutura RASENTRYDLG .

lpInfo

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

dwFlags

Reservado para uso futuro.

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 RasEntryDlg, se o membro szCustomDialDll da estrutura RASENTRY para a entrada que está sendo discada especifica uma DLL de discagem personalizada.

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

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