This article is intended for Citrix administrators and technical teams only.

Non-admin users must contact their company’s Help Desk/IT support team and can refer to CTX297149 for more information.

Protocol driver error message in earlier versions

While using receiver a common error that you might encounter is the protocol driver error. It’s a super set of a number of errors and there could be many reasons for it. To find the main reason we need to debug code or use CDF traces, which could be a daunting task.

Improvement in 4.10

In this release we are including all Socket and some SSL errors in place of protocol driver errors.

In socket errors we have provided minimal information with error code. To obtain more information, run command “net helpmsg <error code>” in command prompt or go to msdn page and search for socket error codes and corresponding description. (Note: More windows errors can be found here).

Note: We have added a toggle switch to avoid new errors and switch back to old behaviour. A GPO policy is added under “Citrix Receiver -> Client Engine -> Enable Engine Error Messages”. By default new error behaviour is enabled. Selecting Disable from GPO policy with switch it to old behaviour.

Socket and SSL errors in 4.10

Below are some of the error that you might encounter:

**The error format has been changed to “Unable to connect to the server. Contact your system administrator with the following error: <Error msg string> (Socket/SSL Error <Error Code ID>).

Socket errors

These errors will be thrown if there is either outgoing connection problems or connection problems on the client or server end. Resulting in network disconnection for Receiver wfica.exe process. To correct it we need to allow the internet connection. Few reason for internet disconnection and how to solve is given below:

Problem	Solution
Firewall has been enabled which is blocking internet.	Disable firewall* to continue working.
Ethernet has been disabled / Ethernet cable is loose.	Enable Ethernet**.
Wi-Fi connection is broken.	Check for Wi-Fi connection.
Anti-virus has blocked Receiver or outgoing connections.	Check for your Anti-virus.

Examples of few socket errors:
Unable to connect to the server. Contact your system administrator with the following error: Permission denied. (Socket Error 10013)

Unable to connect to the server. Contact your system administrator with the following error: The Citrix XenApp server you have selected is not accepting connections. (Socket Error 10051)

Unable to connect to launch your application. Contact your help desk with the following information: Cannot connect to the Citrix XenApp server. Software caused connection abort.

Unable to launch your application. Contact your help desk with the following information: Cannot connect to the Citrix XenApp server. Can't assign requested address

SSL errors

• Un-matching certificate (Expired Certificate)
  Unable to launch your application. Contact your help desk with the following information: Cannot connect to the Citrix XenApp server. The Citrix SSL server you have selected is not accepting connections.
   
• Certificate revoked 
  Unable to launch your application. Contact your help desk with the following information: Cannot connect to the Citrix XenApp server. SSL Error 76: The security certificate "<certificate>" (serial number <serial number>) was revoked by "...". (Reason:KEY_COMPROMISE)
   

*Reproduction steps for firewall enable

1. Go to Control Panel -> System and Security -> Windows Firewall
   1. Go to “Allow an app or feature through Windows Firewall”.
      1. Search if Receiver/Wfica32 is include in the list.
      2. If yes, check for checkboxes under domain, private and public.
      3. Make sure the checkboxes are checked
   2. Go to “Turn Firewall on or off”
      1. Search for Domain, Private or Public network settings
      2. Make sure “Notify me when Windows firewall blocks a new app” is clicked.
   3. Go to “Advanced Settings”
      1. Click on Inbound and Outbound rules.
      2. Search for rules blocking internet connection for Receiver or any of receiver processes.
      3. If there is rule blocking internet connections. Disable it.

**Reproduction steps for Ethernet Enable

1. Open “Control Panel” -> “Network and Internet” -> Network Connections
2. Right click on the Ethernet you are connected to -> Click Enable.

      OR

1. In case your Ethernet cable is loose. Tighten the Ethernet cable

Citrix is not responsible for and does not endorse or accept any responsibility for the contents or your use of these third party Web sites. Citrix is providing these links to you only as a convenience, and the inclusion of any link does not imply endorsement by Citrix of the linked Web site. It is your responsibility to take precautions to ensure that whatever Web site you use is free of viruses or other harmful items.

In Receiver for Windows 4.10, general protocol driver error messages are replaced with improved Socket and SSL errors.