NetworkIsolationDiagnoseConnectFailureAndGetInfo function (netfw.h)

The NetworkIsolationDiagnoseConnectFailureAndGetInfo function gets information about a network isolation connection failure due to a missing capability. This function can be used to identify the capabilities required to connect to a server.

Syntax

DWORD NetworkIsolationDiagnoseConnectFailureAndGetInfo(
  [in]  LPCWSTR           wszServerName,
  [out] NETISO_ERROR_TYPE *netIsoError
);

Parameters

[in] wszServerName

Type: LPCWSTR

Name (or IP address literal string) of the server to which a connection was attempted.

[out] netIsoError

Type: NETISO_ERROR_TYPE*

The error that has occurred, indicating which network capability was missing and thus caused the failure.

Return value

Type: DWORD

Returns ERROR_SUCCESS if successful, or an error value otherwise.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server Windows Server 2012 [desktop apps only]
Target Platform Windows
Header netfw.h (include Netfw.h)
DLL Firewallapi.dll

See also

NETISO_ERROR_TYPE