Funzione RasCreatePhonebookEntryA (ras.h)

Articolo
11/20/2024

[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 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.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti o un valore di Codici di errore di routing e accesso remoto o Winerror.h.

Codice restituito	Descrizione
ERROR_CANNOT_OPEN_PHONEBOOK	La rubrica telefonica è danneggiata o mancano componenti.

Osservazioni

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

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

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 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	ras.h
libreria	Rasapi32.lib
dll	Rasapi32.dll