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

Confira também

RASPBDLG

Visão geral do RAS (Serviço de Acesso Remoto)

Funções do serviço de acesso remoto