Funzione RasPhonebookDlgA (rasdlg.h)

La funzione RasPhonebookDlg visualizza la finestra di dialogo Principale Rete remota . Da questa finestra di dialogo modale, l'utente può comporre, modificare o eliminare una voce di rubrica telefonica selezionata, creare una nuova voce della rubrica telefonica o specificare le preferenze dell'utente. La funzione RasPhonebookDlg restituisce quando la finestra di dialogo viene chiusa.

Sintassi

BOOL RasPhonebookDlgA(
  [in]      LPSTR       lpszPhonebook,
  [in]      LPSTR       lpszEntry,
  [in, out] LPRASPBDLGA lpInfo
);

Parametri

[in] lpszPhonebook

Puntatore a una stringa con terminazione Null che specifica il percorso completo e il nome file di un file di rubrica telefonica (PBK). Se questo parametro è NULL, la funzione usa il file di rubrica predefinito corrente. Il file predefinito della rubrica telefonica è quello selezionato dall'utente nella finestra delle proprietà Preferenze utente della finestra di dialogo Rete remota.

[in] lpszEntry

Puntatore a una stringa con terminazione Null che specifica il nome della voce della rubrica telefonica da evidenziare inizialmente. Se questo parametro è NULL o se la voce specificata non esiste, la finestra di dialogo evidenzia la prima voce nell'elenco alfabetico.

[in, out] lpInfo

Puntatore alla struttura RASPBDLG che specifica parametri di input e output aggiuntivi.

In input, il membro dwSize di questa struttura deve specificare sizeof( RASPBDLG).

Se si verifica un errore, il membro dwError della struttura riceve, nell'output, un codice di errore; in caso contrario, riceve zero.

Valore restituito

Se l'utente seleziona il pulsante Connetti e la funzione stabilisce una connessione, il valore restituito è TRUE. In caso contrario, la funzione restituisce FALSE.

Se si verifica un errore, il membro dwError della struttura RASPBDLG restituisce un valore da Routing e Remote Access Error Codes o Winerror.h.

Nel codice di esempio seguente viene visualizzata la finestra di dialogo Rete remota . Nella finestra di dialogo vengono visualizzate le informazioni di composizione per la prima voce del file phonebook predefinito.

#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;
}

Commenti

Nota

L'intestazione rasdlg.h definisce RasPhonebookDlg come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione rasdlg.h
Libreria Rasdlg.lib
DLL Rasdlg.dll

Vedi anche

RASPBDLG

Panoramica del servizio accesso remoto (RAS)

Funzioni del Servizio di accesso remoto