Funzione RasPhonebookDlgA (rasdlg.h)

Articolo
11/20/2024

La funzione rasPhonebookDlg visualizza la finestra di dialogo rete remota principale. Da questa finestra di dialogo modale, l'utente può comporre, modificare o eliminare una voce di rubrica telefonica selezionata, creare una nuova voce rubrica telefonica o specificare le preferenze utente. La funzione RasPhonebookDlg viene restituita 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 un nullstringa con terminazione che specifica il percorso completo e il nome file di un file con rubrica telefonica (PBK). Se questo parametro è NULL, la funzione usa il file predefinito corrente della rubrica telefonica. Il file predefinito della rubrica telefonica è quello selezionato dall'utente nella finestra di dialogo Preferenze utente della finestra di dialogo Rete remota.

[in] lpszEntry

Puntatore a un nullstringa con terminazione che specifica il nome della voce della rubrica telefonica da evidenziare inizialmente. Se questo parametro è NULLo 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 caso di input, il membro dwSize di questa struttura deve specificare sizeof( RASPBDLG).

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

Valore restituito

Se l'utente seleziona il pulsante Connect 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 Codici di errore di routing e accesso remoto 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 dal 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;
}

Osservazioni

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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	rasdlg.h
libreria	Rasdlg.lib
dll	Rasdlg.dll

Vedere anche

RASPBDLG

Panoramica servizio di accesso remoto (RAS)

funzioni del servizio accesso remoto

Condividi tramite