SHStartNetConnectionDialogW-Funktion (shlobj_core.h)

  • Artikel

[SHStartNetConnectionDialog 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.]

Zeigt ein allgemeines Dialogfeld zum Durchsuchen einer Netzwerkressourcenverbindung an.

Syntax

SHSTDAPI SHStartNetConnectionDialogW(
  [in, optional] HWND    hwnd,
  [in, optional] LPCWSTR pszRemoteName,
                 DWORD   dwType
);

Parameter

[in, optional] hwnd

Typ: HWND

Ein Handle für das übergeordnete Fenster.

[in, optional] pszRemoteName

Typ: LPCTSTR

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des Remotenetzwerks angibt. Dieser Wert kann auf NULL festgelegt werden.

dwType

Art: DWORD

Ein Bitfeld, das eine Reihe von Flags enthält, die den Typ der Ressource angeben, für die das Dialogfeld festgelegt ist. Dieser Wert kann einen der folgenden Werte enthalten, die in Winnetwk.h definiert sind:

RESOURCETYPE_ANY (0x00000000)

Alle Ressourcen

RESOURCETYPE_DISK (0x00000001)

Datenträgerressourcen

RESOURCETYPE_PRINT (0x00000002)

Drucken von Ressourcen

Rückgabewert

Typ: HRESULT

Gibt immer S_OK zurück.

Hinweise

Hinweis

Der shlobj_core.h-Header definiert SHStartNetConnectionDialog als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

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 (einschließlich Shlobj.h, Shlobj_core.h)
Bibliothek Shell32.lib
DLL Shell32.dll (Version 5.0 oder höher)