Funzione SHValidateUNC (shlobj_core.h)

Articolo
03/15/2023

[SHValidateUNC è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Può essere modificato o non disponibile nelle versioni successive.

Convalida un percorso UNC (Universal Naming Convention) chiamando WNetAddConnection3. La funzione consente all'utente di digitare un'applicazione UNC (RNA) di accesso remoto o un nome documento dalla finestra di dialogo Esegui nel menu Start .

Sintassi

BOOL SHValidateUNC(
  [in, optional] HWND  hwndOwner,
  [in, out]      PWSTR pszFile,
                 UINT  fConnect
);

Parametri

[in, optional] hwndOwner

Tipo: HWND

Handle della finestra padre, utilizzata per visualizzare l'interfaccia utente. Se non è necessario, questo valore può essere impostato su NULL.

[in, out] pszFile

Tipo: PWSTR

Puntatore a una stringa Unicode con terminazione null che specifica il percorso UNC da convalidare. Nota: questa stringa non deve essere una stringa costante.

fConnect

Tipo: UINT

Uno o più dei valori seguenti.

VALIDATEUNC_CONNECT (0x0001)

Connettere una lettera di unità. Quando questo flag viene impostato, il valore in pszFile viene modificato nell'unità locale in cui viene eseguito il mapping dell'unC nel computer locale.

VALIDATEUNC_NOUI (0x0002)

In caso di errore o esito positivo, non viene visualizzata alcuna interfaccia utente.

VALIDATEUNC_PRINT (0x0004)

Convalidare come condivisione di stampa anziché condivisione disco.

VALIDATEUNC_PERSIST (0x0008)

Windows Vista e versioni successive. La connessione deve essere resa persistente.

VALIDATEUNC_VALID

Valore mask usato per verificare che i flag passati a SHValidateUNC siano validi.

Valore restituito

Tipo: BOOL

Restituisce TRUE se esiste il percorso UNC; FALSE se il percorso UNC non esiste o se si è verificato un altro errore.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlobj_core.h (include Shlobj.h)
Libreria	Shell32.lib
DLL	Shell32.dll (versione 5.00 o successiva)

Condividi tramite