Funzione WNetConnectionDialog1A (winnetwk.h)

Articolo
11/20/2024

La funzione WNetConnectionDialog1 visualizza una finestra di dialogo generale di esplorazione per la connessione alle risorse di rete. La funzione richiede un CONNECTDLGSTRUCT per stabilire i parametri della finestra di dialogo.

Sintassi

DWORD WNetConnectionDialog1A(
  [in, out] LPCONNECTDLGSTRUCTA lpConnDlgStruct
);

Parametri

[in, out] lpConnDlgStruct

Puntatore a una struttura CONNECTDLGSTRUCT. La struttura stabilisce i parametri del dialogo di esplorazione.

Valore restituito

Se l'utente annulla la finestra di dialogo, la funzione restituisce -1. Se la funzione ha esito positivo, restituisce NO_ERROR. Inoltre, se la chiamata ha esito positivo, il membro dwDevNum della struttura CONNECTDLGSTRUCT contiene il numero del dispositivo connesso.

In genere, questa finestra di dialogo restituisce un errore solo se l'utente non può immettere una sessione di dialogo. Ciò è dovuto al fatto che gli errori che si verificano dopo una sessione di dialogo vengono segnalati direttamente all'utente. Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema , ad esempio uno dei valori seguenti.

Codice restituito	Descrizione
ERROR_INVALID_PARAMETER	Vengono impostate sia le opzioni CONNDLG_RO_PATH che le opzioni della finestra di dialogo CONNDLG_USE_MRU. Le opzioni della finestra di dialogo vengono specificate dal membro dwFlags della struttura CONNECTDLGSTRUCT . -o- Vengono impostate sia le opzioni di CONNDLG_PERSIST che di CONNDLG_NOT_PERSIST finestra di dialogo. -o- L'opzione della finestra di dialogo CONNDLG_RO_PATH è impostata e il membro lpRemoteName della struttura NETRESOURCE non punta a una rete remota. La struttura CONNECTDLGSTRUCT punta a una struttura NETRESOURCE.
ERROR_BAD_DEV_TYPE	Il membro dwType della struttura NETRESOURCE non è impostato su RESOURCETYPE_DISK.
ERROR_BUSY	Il provider di rete è occupato (possibilmente inizializzazione). Il chiamante deve riprovare.
ERROR_NO_NETWORK	La rete non è disponibile.
ERROR_NOT_ENOUGH_MEMORY	Memoria insufficiente per visualizzare la finestra di dialogo.
ERROR_EXTENDED_ERROR	Si è verificato un errore specifico della rete. Chiamare WNetGetLastError per ottenere una descrizione dell'errore.

Osservazioni

Nota

L'intestazione winnetwk.h definisce WNetConnectionDialog1 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	winnetwk.h
libreria	Mpr.lib
dll	Mpr.dll