Installation Checklist

  • Article

Applies to: Office 2007 | Outlook 2010 | SharePoint Server 2010

This topic describes prerequisites for successfully installing a Microsoft Outlook Social Connector (OSC) provider, and the installation checks that your provider installer should complete to work correctly.

Installation Overview

Users should install OSC providers only if a supporting version of Microsoft Outlook is present and the OSC is installed and enabled on the client computer. Supporting versions of Outlook are Microsoft Office Outlook 2003, Microsoft Office Outlook 2007, or Microsoft Outlook 2010 (installed on the client computer or, in the case of Outlook 2010, delivered by Click-to-Run on the client computer). To ensure a successful installation, your provider installer should do the following:

  • Verify whether a supported version of Outlook is present.

  • Verify whether the OSC is installed.

Note

Click-to-Run is a virtual environment in which 32-bit Outlook 2010 can run. For more information about delivering Outlook as a Click-to-Run product on a client computer, see How to Verify if Outlook is Available on a Computer as a Click-to-Run Product.

The user, however, has to ensure that the OSC is enabled before installing the provider.

Third parties, including OSC providers, cannot redistribute the OSC. However, if the OSC is not installed, the provider installer can use appropriate g-links to install the OSC on the client computer. A g-link is a specially constructed URL on http://g.live.com that forwards a user to a corresponding webpage to download the OSC. An OSC g-link is formatted as http://g.live.com/0CRLCID/Glink, where LCID and Glink specify the locale, version, and bitness of Outlook on the client computer. Each g-link points to an executable and is specific to the specified LCID and Glink values.

For example, the g-link to install the latest version of the OSC for Outlook 2003 or Outlook 2007 for the LCID 1033 (US English) is as follows:

http://g.live.com/0CR1033/80

For details about Glink values for different versions and bitness of Outlook, and LCID values for supported locales, see #7 in the section Installation Checklist below.

Installation Checklist

The provider setup package should perform a series of installation checks, as shown in Figure 1, to ensure that the provider installs successfully.

Figure 1. Provider installation logic

Installation checklist

The following procedure describes the installation checks outlined in Figure 1.

  1. As a prerequisite, detect whether Outlook is installed or present, and if installed or present, determine whether the version of Outlook supports the OSC. For more information about detecting the installed version of Outlook, see How to: Check the Version of Outlook.

    • If the installed version of Outlook is earlier than Outlook 2003, the provider installation procedure cannot complete. Inform the user to obtain a supported version of Outlook and the OSC before proceeding to install the OSC provider.

    • If Outlook is not installed, proceed to step 2.

    • If Outlook 2003 or Outlook 2007 is installed, proceed to step 3.

    • If Outlook 2010 is installed, proceed to step 4.

  2. Proceed with this step if Outlook is not installed on the client computer:

    1. Check whether the OSC is installed as a default component of a Click-to-Run installation of Outlook 2010 by examining the VirtualOutlook key in the following location in the Windows registry:

      HKEY_LOCAL_MACHINE\Software\Microsoft\Office\14.0\Common\InstallRoot\Virtual\VirtualOutlook

      The VirtualOutlook key is a REG_SZ value that contains the locale tag, such as "en-us", of the installed product.

    2. If the VirtualOutlook key does not exist, Outlook is not present on the client computer, and the provider installation procedure cannot complete. Inform the user to obtain a supported version of Outlook and the OSC before proceeding to install the OSC provider.

    3. If the VirtualOutlook key does exist, Outlook 2010 was delivered by Click-to-Run on the client computer. Proceed to check the installed version of the OSC type library by examining the OSCVersion key in the following location in the Windows registry:

      HKEY_LOCAL_MACHINE\Software\Microsoft\Office\Outlook\SocialConnector\OSCVersion

      The value of OSCVersion is a string that specifies the type library version number of Socialprovider.dll (for example, "1.0" or "1.1").

    4. If OSCVersion is either "1.0" or "1.1", an appropriate version of OSC is installed. Proceed to step 6 to find the current Outlook user interface locale to prepare for installing the latest version of the OSC.

    5. Otherwise, OSCVersion does not contain an expected value. Proceed to step 6 to find the current Outlook user interface locale to prepare for installing an appropriate version of the OSC.

  3. Proceed with this step if Outlook 2003 or Outlook 2007 is installed on the client computer:

    1. Verify whether the OSC is installed by writing an installer custom action to test for the existence of the following qualified component ID:

      {A3B82DA3-8AD9-4935-AEA8-54B754459483}

      The qualified component ID is a GUID that provides a method of single-level indirection, similar to a pointer. For more information about Windows Installer, see Roadmap to Windows Installer Documentation.

    2. If the specified qualified component exists, a version of the OSC is installed. Proceed to step 5 to find the current Outlook user interface locale to prepare for installing the latest version of the OSC.

    3. Otherwise, the OSC is not installed. Proceed to step 6 to find the current Outlook user interface locale to prepare for installing an appropriate version of the OSC.

  4. Proceed with this step if Outlook 2010 is installed on the client computer:

    1. Determine the bitness of the installed version of Outlook 2010 by examining the Bitness key in the following location in the Windows registry:

      HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\14.0\Outlook

      The Bitness key is "x86" for 32-bit Outlook 2010, or "x64" for 64-bit Outlook 2010.

    2. If your provider is a managed provider, and you compiled the provider component specifying the target platform as Any CPU, proceed with step 6 to find the current Outlook user interface locale to prepare for installing the latest version of the OSC. Your provider will work on both 32-bit and 64-bit versions of the OSC.

    3. If your provider is a native COM component, examine the bitness of the installed version of Outlook:

      • If the installed version of Outlook is 32-bit, your installation procedure will have to install a 32-bit provider (in step 8), after ensuring that an appropriate OSC is installed.

      • Otherwise, the installed version of Outlook is 64-bit, and your installation procedure will have to install a 64-bit provider (in step 8), after ensuring that an appropriate OSC is installed.

    4. Proceed with step 6 to find the current Outlook user interface locale to prepare for installing an appropriate version of the OSC.

  5. Proceed with this step if Outlook 2003 or Outlook 2007 is installed, and the OSC is installed on the client computer: Check the current Outlook user interface locale by examining the OSCLcid key in the following location in the Windows registry:

    HKEY_LOCAL_MACHINE\Software\Microsoft\Office\Outlook\SocialConnector\OSCLcid

    The OSCLcid key is a DWORD value that specifies the Internet Engineering Task Force (IETF) locale tag (defined by [RFC4646] and [RFC4647]), that represents the current Outlook user interface locale. Proceed with step 7 to install the latest OSC on the client computer.

  6. Proceed with this step if Outlook 2003 or Outlook 2007 is installed, or Outlook 2010 is present, but the latest OSC is not necessarily installed on the client computer:

    Use the LanguageSettings object to determine the LCID of the Outlook user interface locale. The following Visual Basic Scripting Edition (VBScript) code snippet demonstrates how to obtain the LCID of the Outlook user interface locale.

    Function GetOutlookUI_LCID()
    ' Declare variables.
    Dim msoLanguageIDUI, olApp
    msoLanguageIDUI = 2
    Set olApp = CreateObject("Outlook.Application")
    ' Return Outlook UI LCID.
    GetOutlookUI_LCID = olApp.LanguageSettings.LanguageID(msoLanguageIDUI)
End Function

  7. Proceed with this step if the installer has the LCID of the installed version of Outlook, but the latest OSC is not necessarily installed on the client computer:

    Chain a g-link into your installation package to ensure that the latest version of the OSC is installed on the client computer. The g-link format is as follows:

    http://g.live.com/0CRLCID/Glink

    Refer to Table 1 below for the supported LCID values, and Table 2 for the supported Glink values. For example, the g-link to install the latest version of the 32-bit OSC for 32-bit Outlook 2010 (US English) is as follows:

    http://g.live.com/0CR1033/82

  8. Install the provider. The provider installation procedure must register the programmatic identifier (ProgID) in the appropriate Windows registry location. For more information, see Registering a Provider. Also, be sure that the bitness of the provider to be installed is the same as the bitness of the version of Outlook present on the client computer. For example, install a 32-bit provider if 32-bit Outlook 2010 is present, and a 64-bit provider if 64-bit Outlook 2010 is installed. For Outlook 2003 or 2007, only the 32-bit version of your provider applies.

Table 1: Supported locale and corresponding LCID values in hexadecimal for the OSC

Locale

LCID

ar-sa

1025

bg-bg

1026

ca-es

1027

cs-cz

1029

da-dk

1030

de-de

1031

el-gr

1032

en-us

1033

es-es

3082

et-ee

1061

eu-es

1069

fi-fi

1035

fr-fr

1036

gl-es

1110

he-il

1037

hi-in

1081

hr-hr

1050

hu-hu

1038

it-it

1040

ja-jp

1041

kk-kz

1087

ko-kr

1042

lt-lt

1063

lv-lv

1062

nb-no

1044

nl-nl

1043

pl-pl

1045

pt-br

1046

pt-pt

2070

ro-ro

1048

ru-ru

1049

sk-sk

1051

sl-si

1060

sr-cyrl-cs

3098

sr-latn-cs

2074

sv-se

1053

th-th

1054

tr-tr

1055

uk-ua

1058

zh-cn

2052

zh-tw

1028

Table 2: Supported Glink values for the OSC

Glink value

Function

80

Installs the latest version of OSC for Outlook 2003 or Outlook 2007.

82

Installs the latest version of 32-bit OSC for Outlook 2010.

83

Installs the latest version of 64-bit OSC for Outlook 2010.

See Also

Concepts

Registering a Provider

Quick Steps for Learning to Develop a Provider

Other Resources

Deploying a Provider