SHValidateUNC-Funktion (shlobj_core.h)

Artikel
03/06/2024

[SHValidateUNC ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Überprüft einen UNC-Pfad (Universal Naming Convention), indem WNetAddConnection3 aufgerufen wird. Die Funktion ermöglicht es dem Benutzer, eine UNC-Anwendung oder einen Dokumentnamen (Remote Network Access, Remote Network Access, RNA) aus dem Dialogfeld Ausführen im Startmenü einzugeben.

Syntax

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

Parameter

[in, optional] hwndOwner

Typ: HWND

Handle des übergeordneten Fensters, das zum Anzeigen der Benutzeroberfläche verwendet wird. Wenn dies nicht erforderlich ist, kann dieser Wert auf NULL festgelegt werden.

[in, out] pszFile

Typ: PWSTR

Ein Zeiger auf eine unicode-Zeichenfolge mit Null-Ende, die den zu überprüfenden UNC-Pfad angibt. Hinweis: Diese Zeichenfolge darf keine konstante Zeichenfolge sein.

fConnect

Typ: UINT

Mindestens einer der folgenden Werte:

VALIDATEUNC_CONNECT (0x0001)

Verbinden Sie einen Laufwerkbuchstaben. Wenn dieses Flag festgelegt ist, wird der Wert in pszFile in das lokale Laufwerk geändert, dem die UNC auf dem lokalen Computer zugeordnet ist.

VALIDATEUNC_NOUI (0x0002)

Bei Einem Fehler oder Erfolg wird keine Benutzeroberfläche angezeigt.

VALIDATEUNC_PRINT (0x0004)

Überprüfen sie als Druckfreigabe und nicht als Datenträgerfreigabe.

VALIDATEUNC_PERSIST (0x0008)

Windows Vista und höher. Die Verbindung sollte dauerhaft hergestellt werden.

VALIDATEUNC_VALID

Maskierungswert, der verwendet wird, um zu überprüfen, ob die an SHValidateUNC übergebenen Flags gültig sind.

Rückgabewert

Typ: BOOL

Gibt TRUE zurück, wenn der UNC-Pfad vorhanden ist. FALSE , wenn der UNC-Pfad nicht vorhanden ist oder ein anderer Fehler aufgetreten ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlobj_core.h (shlobj.h einschließen)
Bibliothek	Shell32.lib
DLL	Shell32.dll (Version 5.00 oder höher)

Freigeben über