Função RasEditPhonebookEntryA (ras.h)

Artigo
03/05/2024

[Essa função foi preterida a partir do Windows Vista e sua funcionalidade foi substituída por RasEntryDlg.]

A função RasEditPhonebookEntry edita uma entrada de catálogo telefônico existente. A função exibe uma caixa de diálogo na qual o usuário pode modificar as informações existentes.

Sintaxe

DWORD RasEditPhonebookEntryA(
  [in] HWND   unnamedParam1,
  [in] LPCSTR unnamedParam2,
  [in] LPCSTR unnamedParam3
);

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 .

[in] unnamedParam3

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome de uma entrada existente no arquivo do catálogo telefônico.

Retornar valor

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_BUFFER_INVALID	O buffer de entrada do catálogo telefônico é inválido.
ERROR_CANNOT_OPEN_PHONEBOOK	A lista telefônica está corrompida ou está faltando componentes.
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	A entrada do catálogo telefônico não existe.

Comentários

Ao chamar RasEntryDlg, defina cada membro da estrutura RASENTRYDLG passada para lpinfo como zero, exceto:

dwSize = sizeof(RASENTRYDLG)
hwndOwner = o parâmetro hwnd acima

Observação

O cabeçalho ras.h define RasEditPhonebookEntry 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

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	ras.h
Biblioteca	Rasapi32.lib
DLL	Rasapi32.dll