Funzione SHStartNetConnectionDialogA (shlobj_core.h)

Articolo
11/20/2024

[ SHStartNetConnectionDialog è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive.]

Visualizza una finestra di dialogo di esplorazione generale per una connessione alle risorse di rete.

Sintassi

SHSTDAPI SHStartNetConnectionDialogA(
  [in, optional] HWND   hwnd,
  [in, optional] LPCSTR pszRemoteName,
                 DWORD  dwType
);

Parametri

[in, optional] hwnd

Tipo: HWND

Handle per la finestra padre.

[in, optional] pszRemoteName

Tipo: LPCTSTR

Puntatore a una stringa di caratteri con terminazione Null che specifica il nome della rete remota. Questo valore può essere impostato su NULL.

dwType

Tipo: DWORD

Un campo di bit che contiene un set di flag che identificano il tipo di risorsa impostato per la ricerca della finestra di dialogo. Questo valore può contenere uno dei valori seguenti, definiti in Winnetwk.h:

RESOURCETYPE_ANY (0x00000000)

Tutte le risorse

RESOURCETYPE_DISK (0x00000001)

Risorse disco

RESOURCETYPE_PRINT (0x00000002)

Stampare le risorse

Valore restituito

Tipo: HRESULT

Restituisce sempre S_OK.

Osservazioni

Nota

L'intestazione shlobj_core.h definisce SHStartNetConnectionDialog 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 XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	shlobj_core.h (includere Shlobj.h, Shlobj_core.h)
libreria	Shell32.lib
dll	Shell32.dll (versione 5.0 o successiva)

Condividi tramite