GetNetworkConnected function
The GetNetworkConnected function launches the Get Connected wizard within the calling application to enable local area network connectivity.
Syntax
HRESULT WINAPI GetNetworkConnected( _In_ const HWND hwndParent, _In_ const DWORD dwWizardType, _In_ const DWORD dwContextFlags, _In_ const DWORD dwUserFlags, _In_ const HANDLE hUserContext, _In_opt_ LPWSTR pszCommandLine );
Parameters
- hwndParent [in]
-
Handle to the parent window that called this API.
This parameter is optional and can be set to NULL.
- dwWizardType [in]
-
Specifies the style of the Get Connected wizard to be launched.
This parameter is optional and can be set to 0.
Value Meaning - 0x00
Default style.
- dwContextFlags [in]
-
A set of context flags that describes wizard behaviors.
This parameter is optional and can be set to 0.
Value Meaning - 0x00
The wizard returns the results synchronously and blocks until this call is complete.
- 0x1
The wizard returns the results immediately and asynchronously via a Windows event.
- dwUserFlags [in]
-
A set of user-defined application-specific flags. These flags are defined and interpreted by the calling application.
This parameter is optional and should be set to 0 by default.
- hUserContext [in]
-
User context handle for the parent application thread.
This parameter is optional and should be set to NULL by default.
- pszCommandLine [in, optional]
-
User command line parameters, if any.
This parameter is optional and can be set to NULL.
The following command-line options are supported:
Return value
If the method succeeds the return value is S_OK.
If the method fails, the return value is one of the standard error codes.
Remarks
This API specifically connects the user to the local network (LAN) by raising the Get Connected wizard to obtain the information necessary to create that connection.
To launch a Get Connected wizard for a VPN connection, call the GetVPNConnected API.
To launch a Get Connected wizard for an Internet connection, call the GetInternetConnected API.
An import library containing the GetNetworkConnected function is not included in the Microsoft Windows Software Development Kit (SDK). Applications must use the GetModuleHandle and GetProcAddress functions to retrieve the function pointer from the corresponding DLL and call this function.
Requirements
|
Minimum supported client | Windows Vista [desktop apps only] |
|---|---|
|
Minimum supported server | Windows Server 2008 [desktop apps only] |
|
DLL |
|