Função RasPhonebookDlgA (rasdlg.h)
A função RasPhonebookDlg exibe a main caixa de diálogo Rede Discada. Nessa caixa de diálogo modal, o usuário pode discar, editar ou excluir uma entrada de catálogo telefônico selecionada, criar uma nova entrada de catálogo telefônico ou especificar preferências do usuário. A função RasPhonebookDlg retorna quando a caixa de diálogo é fechada.
Sintaxe
BOOL RasPhonebookDlgA(
[in] LPSTR lpszPhonebook,
[in] LPSTR lpszEntry,
[in, out] LPRASPBDLGA lpInfo
);
Parâmetros
[in] 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 .
[in] lpszEntry
Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome da entrada do catálogo telefônico a ser realçada inicialmente. Se esse parâmetro for NULL ou se a entrada especificada não existir, a caixa de diálogo realçará a primeira entrada na lista alfabética.
[in, out] lpInfo
Ponteiro para a estrutura RASPBDLG que especifica parâmetros adicionais de entrada e saída.
Na entrada, o membro dwSize dessa estrutura deve especificar o sizeof( RASPBDLG).
Se ocorrer um erro, o membro dwError da estrutura receberá, na saída, um código de erro; caso contrário, ele receberá zero.
Valor retornado
Se o usuário selecionar o botão Conectar e a função estabelecer uma conexão, o valor retornado será TRUE. Caso contrário, a função retornará FALSE.
Se ocorrer um erro, o membro dwError da estrutura RASPBDLG retornará um valor de Códigos de Erro de Roteamento e Acesso Remoto ou Winerror.h.
O código de exemplo a seguir apresenta a caixa de diálogo Rede Discada . A caixa de diálogo exibe informações de discagem para a primeira entrada do arquivo de pasta de telefone padrão.
#include <windows.h>
#include <stdio.h>
#include "ras.h"
#include "rasdlg.h"
#pragma comment(lib, "rasapi32.lib")
int main (){
// Initialize the return code
BOOL nRet = TRUE;
// Allocate heap memory for the RASPBLDG structure
RASPBDLG * lpInfo = (LPRASPBDLG)HeapAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY, sizeof(RASPBDLG));
// The dwsize member of lpInfo must contain the structure size, or the
// call to RasPhonebookDlg will fail
lpInfo->dwSize = sizeof(RASPBDLG);
// Open a user dialog box
nRet = RasPhonebookDlg(NULL,NULL,lpInfo);
if(nRet == TRUE){
// The user dialed a connection successfully
printf("User pressed Connect\n");
}else{
if(lpInfo->dwError != 0){
printf("RasPhonebookDlg failed: Error = %d\n", lpInfo->dwError);
}else{
// The user closed the dialog box manually
printf("User pressed Close\n");
}
}
// Free the heap memory for the RASPBLDG structure
HeapFree(GetProcessHeap(), 0, lpInfo);
return 0;
}
Comentários
Observação
O cabeçalho rasdlg.h define RasPhonebookDlg 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 | rasdlg.h |
| Biblioteca | Rasdlg.lib |
| DLL | Rasdlg.dll |