Funzione RasEntryDlgA (rasdlg.h)

La funzione RasEntryDlg visualizza le finestre delle proprietà modali che consentono a un utente di modificare le voci della rubrica telefonica. Se si modifica o si copia una voce di rubrica telefonica esistente, la funzione visualizza una finestra delle proprietà di immissione della rubrica telefonica. La funzione RasEntryDlg restituisce quando l'utente chiude la finestra delle proprietà.

Sintassi

BOOL RasEntryDlgA(
  [in] LPSTR          lpszPhonebook,
  [in] LPSTR          lpszEntry,
  [in] LPRASENTRYDLGA 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 modificare, copiare o creare.

Se si sta modificando o copiando una voce, questo parametro è il nome di una voce di rubrica telefonica esistente. Se si copia una voce, impostare il flag RASEDFLAG_CloneEntry nel membro dwFlags della struttura RASENTRYDLG .

[in] lpInfo

Puntatore a una struttura RASENTRYDLG che specifica parametri di input e output aggiuntivi. Il membro dwSize di questa struttura deve specificare sizeof(RASENTRYDLG). Utilizzare il membro dwFlags per indicare se si sta creando, modificando o copiando una voce. Se si verifica un errore, il membro dwError restituisce un codice di errore; in caso contrario, restituisce zero.

Valore restituito

Se l'utente crea, copia o modifica una voce della rubrica telefonica, il valore restituito è TRUE. In caso contrario, la funzione restituisce FALSE.

Se si verifica un errore, RasEntryDlg imposta il membro dwError della struttura RASENTRYDLG su un valore da Routing e Remote Access Error Codes o Winerror.h.

Commenti

Le funzioni RasCreatePhonebookEntry e RasEditPhonebookEntry chiamano la funzione RasEntryDlg .

Nel codice di esempio seguente viene visualizzata una finestra delle proprietà per creare una nuova voce. La variabile lpszEntry specifica il nome predefinito per la nuova voce.

#include <windows.h>
#include <stdio.h>
#include "ras.h"
#include "rasdlg.h"
#include <tchar.h>

DWORD __cdecl wmain(){

    DWORD dwRet = ERROR_SUCCESS;
    BOOL nRet = TRUE;
    LPTSTR lpszEntry = L"EntryName";

    // Allocate heap memory and initialize RASENTRYDLG structure
    LPRASENTRYDLG lpEntry = (LPRASENTRYDLG)HeapAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY, sizeof(RASENTRYDLG));
    if (lpEntry == NULL){
        wprintf(L"HeapAlloc failed.\n");
        return 0;
    }
    
    // The RASENTRYDLG->dwSize member has to be initialized or the RRAS APIs will fail below.
    lpEntry->dwSize = sizeof(RASENTRYDLG);
    lpEntry->dwFlags |= RASEDFLAG_NewEntry;

    // Create the new entry using a user dialog
    nRet = RasEntryDlg(NULL, lpszEntry, lpEntry);

    // Any error codes are returned in lpEntry
    dwRet = lpEntry->dwError;
    
    if (nRet == TRUE) {
        wprintf(L"New entry created: %s\n", lpEntry->szEntry);

        // Clean up: delete the new entry
        dwRet = RasDeleteEntry(NULL, lpszEntry);
        if (dwRet != ERROR_SUCCESS) {
            wprintf(L"RasDeleteEntry failed: Error = %d\n", dwRet);
        }

    } 
    else {
        if (dwRet != ERROR_SUCCESS) {
            wprintf(L"RasEntryDlg failed: Error = %d\n", dwRet);
        }
        else {
            wprintf(L"User pressed Cancel\n");
        }
    }

    HeapFree(GetProcessHeap(), 0, lpEntry);
    return 0;
}

Requisiti

Vedi anche

RASENTRYDLG

RasCreatePhonebookEntry

RasCustomEntryDlg

RasEditPhonebookEntry

Panoramica del servizio accesso remoto (RAS)

Funzioni del Servizio di accesso remoto