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 |