Funzione di callback RasCustomEntryDlgFn (rasdlg.h)

Articolo
03/09/2024

La funzione RasCustomEntryDlg è una funzione definita dall'applicazione esportata da una DLL personalizzata di terze parti. Questa funzione consente ai fornitori di terze parti di implementare dialoghi personalizzati per la gestione delle voci della rubrica telefonica.

Sintassi

RasCustomEntryDlgFn Rascustomentrydlgfn;

BOOL Rascustomentrydlgfn(
  HINSTANCE hInstDll,
  LPWSTR lpszPhonebook,
  LPWSTR lpszEntry,
  LPRASENTRYDLG lpInfo,
  DWORD dwFlags
)
{...}

Parametri

hInstDll

Gestire l'istanza della DLL di composizione personalizzata caricata.

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.

lpszEntry

Puntatore a una stringa con terminazione Null contenente 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 .

Se si crea una voce, questo parametro è un nuovo nome di voce predefinito che l'utente può modificare. Se questo parametro è NULL, la funzione fornisce un nome predefinito. Se si crea una voce, impostare il flag RASEDFLAG_NewEntry nel membro dwFlags della struttura RASENTRYDLG .

lpInfo

Puntatore a una struttura RASENTRYDLG che contiene parametri di input e output aggiuntivi. All'input, il membro dwSize di questa struttura deve specificare sizeof( RASENTRYDLG). Utilizzare il membro dwSize per indicare se creare, modificare o copiare una voce. Se si verifica un errore, il membro dwError restituisce un codice di errore; in caso contrario, restituisce zero.

dwFlags

Riservato per utilizzi futuri.

Valore restituito

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

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

Commenti

RAS chiama questo punto di ingresso da RasEntryDlg, se il membro szCustomDialDll della struttura RASENTRY per la voce da comporre specifica una DLL di composizione personalizzata.

Se la DLL con composizione personalizzata non supporta questo punto di ingresso, RAS restituisce ERROR_NO_CUSTOMENTRYDLG al chiamante di RasEntryDlg.

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	rasdlg.h