Funzione RasEditPhonebookEntryA (ras.h)
[Questa funzione è stata deprecata a partire da Windows Vista e la relativa funzionalità è stata sostituita da RasEntryDlg.]
La funzione RasEditPhonebookEntry modifica una voce di rubrica telefonica esistente. La funzione visualizza una finestra di dialogo in cui l'utente può modificare le informazioni esistenti.
Sintassi
DWORD RasEditPhonebookEntryA(
[in] HWND unnamedParam1,
[in] LPCSTR unnamedParam2,
[in] LPCSTR unnamedParam3
);
Parametri
[in] unnamedParam1
Handle nella finestra padre della finestra di dialogo.
[in] unnamedParam2
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] unnamedParam3
Puntatore a una stringa con terminazione Null che specifica il nome di una voce esistente nel file della rubrica telefonica.
Valore restituito
Se la funzione ha esito positivo, il valore restituito viene ERROR_SUCCESS.
Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti o un valore di Routing e Remote Access Error Codes o Winerror.h.
Codice restituito | Descrizione |
---|---|
|
Il buffer di immissione della rubrica telefonica non è valido. |
|
La rubrica è danneggiata o mancante. |
|
La voce della rubrica telefonica non esiste. |
Commenti
Quando si chiama RasEntryDlg, impostare ogni membro della struttura RASENTRYDLG passata a lpinfo su zero tranne:
- dwSize = sizeof(RASENTRYDLG)
- hwndOwner = il parametro hwnd precedente
Nota
L'intestazione ras.h definisce RasEditPhonebookEntry 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
Requisito | Valore |
---|---|
Client minimo supportato | Windows 2000 Professional [solo app desktop] |
Server minimo supportato | Windows 2000 Server [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | ras.h |
Libreria | Rasapi32.lib |
DLL | Rasapi32.dll |