Função RasCreatePhonebookEntryA (ras.h)

Artigo
11/20/2024

[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 lista telefônica. A função exibe uma caixa de diálogo na qual o usuário digita informações para a entrada da lista telefônica.

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 um cadeia de caracteres nulaterminada que especifica o caminho completo e o nome do arquivo de um arquivo PBK (phone-book). Se esse parâmetro for NULL, a função usará o arquivo de agendamento telefônico padrão atual. O arquivo de lista telefônica padrão é o selecionado pelo usuário na folha de propriedades preferências do usuário da caixa de diálogo rede discada .

Valor de retorno

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
ERROR_CANNOT_OPEN_PHONEBOOK	A lista telefônica está corrompida ou está faltando componentes.

Observações

Ao chamar RasDialDlg, defina cada membro da estrutura RASDIALDLG passada para lpInfo como zero, exceto:

dwSize = sizeof(RASDIALDLG)
hwndOwner = o parâmetro hwnd acima
= RASEDFLAG_NewEntry dwFlags

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	ras.h
biblioteca	Rasapi32.lib
de DLL	Rasapi32.dll