Função RasCreatePhonebookEntryA (ras.h)
[Essa função foi preterida a partir do Windows Vista e sua funcionalidade foi substituída por RasDialDlg. ]
A função RasCreatePhonebookEntry cria uma nova entrada de catálogo telefônico. A função exibe uma caixa de diálogo na qual o usuário digita informações para a entrada do catálogo telefônico.
Sintaxe
DWORD RasCreatePhonebookEntryA(
[in] HWND unnamedParam1,
[in] LPCSTR unnamedParam2
);
Parâmetros
[in] unnamedParam1
Manipule para a janela pai da caixa de diálogo.
[in] unnamedParam2
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 .
Valor retornado
Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS.
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.
Código de retorno | Descrição |
---|---|
|
A lista telefônica está corrompida ou está faltando componentes. |
Comentários
Ao chamar RasDialDlg, defina cada membro da estrutura RASDIALDLG passada para lpInfo como zero, exceto:
- dwSize = sizeof(RASDIALDLG)
- hwndOwner = o parâmetro hwnd acima
- Dwflags = RASEDFLAG_NewEntry
Observação
O cabeçalho ras.h define RasCreatePhonebookEntry 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. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
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 |
Biblioteca | Rasapi32.lib |
DLL | Rasapi32.dll |
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de