Funzione RasCreatePhonebookEntryA (ras.h)

Articolo
03/15/2023

[Questa funzione è stata deprecata a partire da Windows Vista e la relativa funzionalità è stata sostituita da RasDialDlg. ]

La funzione RasCreatePhonebookEntry crea una nuova voce della rubrica telefonica. La funzione visualizza una finestra di dialogo in cui l'utente digita informazioni per la voce della rubrica telefonica.

Sintassi

DWORD RasCreatePhonebookEntryA(
  [in] HWND   unnamedParam1,
  [in] LPCSTR unnamedParam2
);

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.

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
ERROR_CANNOT_OPEN_PHONEBOOK	La rubrica è danneggiata o mancante.

Commenti

Quando si chiama RasDialDlg, impostare ogni membro della struttura RASDIALDLG passata a lpInfo su zero tranne:

dwSize = sizeof(RASDIALDLG)
hwndOwner = il parametro hwnd precedente
Dwflags = RASEDFLAG_NewEntry

Nota

L'intestazione ras.h definisce RasCreatePhonebookEntry 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	ras.h
Libreria	Rasapi32.lib
DLL	Rasapi32.dll