labeling_the_click-to-run_virtual_drive

Labeling the Click-to-Run Virtual Drive v1.0 April 19, 2010

Summary Microsoft Office Starter 2010 will be preinstalled on OEM machines, and uses the new Click-to-Run (C2R) technology to host the Office Starter files in a virtualized application space. This restricted space is mapped to a drive which cannot be access by the user, but is visible in Windows Explorer. To help communicate to the user that this drive is not accessible, Microsoft provides OEMs with the ability to label this drive with a more descriptive localized label.

Intended Audience This document is targeted to OEM technical engineers working with Microsoft® Office 2010 OPK.

Supported Operating Systems 

Microsoft Windows Vista® SP1 or higher



Microsoft Windows® 7 all versions

Supported Microsoft Office Versions 

Microsoft ® Office 2010 OEM

Disclaimer Information in this document, including URL and other Internet Web site references, is subject to change without notice and is provided for informational purposes only. The entire risk of the use or results of the use of this document remain with the user, and Microsoft Corporation makes no warranties, either express or implied. Unless otherwise noted, the example companies, organizations, products, people, and events depicted herein are fictitious. No association with any real company, organization, product, person, or event is intended or should be inferred. Complying with all applicable copyright laws is the responsibility of the user. Without limiting the rights under copyright, no part of this document may be reproduced, stored in, or introduced into a retrieval system, or transmitted in any form or by any means (electronic, mechanical, photocopying, recording, or otherwise), or for any purpose, without the express written permission of Microsoft Corporation.

Microsoft may have patents, patent applications, trademarks, copyrights, or other intellectual property rights covering subject matter in this document. Except as expressly provided in any written agreement with Microsoft, the furnishing of this document does not give you any license to these patents, trademarks, copyrights, or other intellectual property. Š 2010 Microsoft Corporation. All rights reserved.

Microsoft, MS-DOS, Windows, Windows NT, Windows Vista and Windows 7 are either registered trademarks or trademarks of Microsoft Corporation in the United States or other countries/regions.

The names of actual companies and products mentioned herein may be the trademarks of their respective owners.

MICROSOFT DOES NOT MAKE ANY REPRESENTATION OR WARRANTY REGARDING SPECIFICATIONS IN THIS DOCUMENT OR ANY PRODUCT OR ITEM DEVELOPED BASED ON THESE SPECIFICATIONS. MICROSOFT DISCLAIMS ALL EXPRESS AND IMPLIED WARRANTIES, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OR MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND FREEDOM FROM INFRINGEMENT. WITHOUT LIMITING THE GENERALITY OF THE FOREGOING, MICROSOFT DOES NOT MAKE ANY WARRANTY OF ANY KIND THAT ANY ITEM DEVELOPED BASED ON THESE SPECIFICATIONS, OR ANY PORTION OF A SPECIFICATION, WILL NOT INFRINGE ANY COPYRIGHT, PATENT, TRADE SECRET OR OTHER INTELLECTUAL PROPERTY RIGHT OF ANY PERSON OR ENTITY IN ANY COUNTRY. IT IS YOUR RESPONSIBILITY TO SEEK LICENSES FOR SUCH INTELLECTUAL PROPERTY RIGHTS WHERE APPROPRIATE. MICROSOFT SHALL NOT BE LIABLE FOR ANY DAMAGES ARISING OUT OF OR IN CONNECTION WITH THE USE OF THESE SPECIFICATIONS, INCLUDING LIABILITY FOR LOST PROFIT, BUSINESS INTERRUPTION, OR ANY OTHER DAMAGES WHATSOEVER. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY OR CONSEQUENTIAL OR INCIDENTAL DAMAGES; THE ABOVE LIMITATION MAY NOT APPLY TO YOU.

SUMMARY ......................................................................................................................................................... 1 INTENDED AUDIENCE .......................................................................................................................................... 1 SUPPORTED OPERATING SYSTEMS ......................................................................................................................... 1 SUPPORTED MICROSOFT OFFICE VERSIONS ............................................................................................................ 1 DISCLAIMER ....................................................................................................................................................... 2 INTRODUCTION .................................................................................................................................................. 4 TECHNICAL DETAILS ............................................................................................................................................. 4 LIST OF APPROVED LOCALIZED LABELS .................................................................................................................... 5 HOW TO CREATE THE REGISTRY KEY THAT ADDS THE LABEL TO THE Q DRIVE ................................................................. 6 QUESTIONS AND ANSWERS .................................................................................................................................. 8 SCREENSHOTS .................................................................................................................................................... 8

Introduction Microsoft Office Starter 2010 will be pre-loaded on OEM machines, and uses the new Click-to-Run(C2R) technology to host the Office Starter files in a virtualized application space. This restricted space is mapped to a drive (Q:) which cannot be accessed by the user.

To help communicate to the user that the Q: drive is not accessible, Microsoft provides OEMs with the ability to label this drive with a more descriptive localized label.

Technical details Click-to-Run (C2R) is using Microsoft virtualization technology to run Office Starter 2010 in an isolated environment. The contents of the virtual file system are exposed through a drive. By default, only programs running inside of the virtual environment will get access to the contents of the drive. Drive access by the user is blocked and attempts to access the drive results in a denial error: “Access is denied”. OEM’s should use a Registry Key to add a label to this drive letter, so that end-users know that this drive is part of the Microsoft Office Starter 2010 implementation.

List of approved localized labels Below is the approved list of labels. These labels are descriptive. OEMs should therefore use the label that matches the user selected preferred OS user interface language.

The non-descriptive label “Microsoft Office 2010” should be used in case an OS UI language has no matching label.

Language

Arabic Basque Brazilian Bulgarian Catalan LIP Chinese (Simplified) Chinese (Traditional) Croatian Czech Danish Dutch English Estonian Finnish French Galician German Greek Hebrew Hindi Hungarian Italian Kazakh Korean Latvian Lithuanian Norwegian Polish Portuguese Romanian Russian Serbian Latin Slovak Slovenian Spanish Swedish Thai Turkish Ukrainian

Label String

)‫ (محمي‬Microsoft Office 2010 ‫التشغيل الفوري لـ‬ "Egin klik eta exekutatu" Microsoft Office 2010 (Babestua) Microsoft Office Clique para Executar 2010 (Protegido) Microsoft Office 2010 със стартиране чрез щракване (защитено) Fer clic i executar de Microsoft Office 2010 (protegit) Microsoft Office 即点即用2010 (受保护) Microsoft Office 隨選即用 2010 (受保護) Microsoft Office Klikni za pokretanje 2010 (zaštićeno) Microsoft Office Klikni a spusť 2010 (chráněný) Microsoft Office Click-to-Run 2010 (beskyttet) Microsoft Office Click-to-Run 2010 (beveiligd) Microsoft Office Click-to-Run 2010 (Protected) Microsoft Office klõpsa-ja-alusta 2010 (kaitstud) Microsoft Office 2010 -pika-asennus (suojattu) Microsoft Office Démarrer en un clic 2010 (Protégé) Execución cun só clic de Microsoft Office 2010 (protexido) Microsoft Office Klick-und-Los 2010 (Geschützt) Microsoft Office "Χρήση με ένα κλικ" 2010 (προστατευμένο) )‫ (מוגן‬2010 Microsoft Office ‫לחץ והפעל של‬ Microsoft Office क्लिक-टू-रन 2010 (संरक्षित) Microsoft Office 2010 adatfolyamos telepítés (védett) Microsoft Office A portata di clic 2010 (protetto) Microsoft Office Іске қосу үшін басу 2010 (Қорғалған) Microsoft Office 간편 실행 2010(보호됨) Microsoft Office Click-to-Run 2010 (aizsargāts) „Microsoft Office 2010“ spustelėk ir paleisk (apsaugota) Microsoft Office Click-to-Run 2010 (beskyttet) Szybka instalacja pakietu Microsoft Office 2010 (Dysk chroniony) Tecnologia Clique-e-Use do Microsoft Office 2010 (Protegido) Microsoft Office clic pentru executare 2010 (protejat) Microsoft Office Click-to-Run 2010 (защищено) Microsoft Office Click-to-Run 2010 (Zaštićeno) Microsoft Office Click-to-Run 2010 (Chránené) Tehnologija Microsoft Office Klikni in zaženi 2010 (zaščiteno) Microsoft Office 2010 Hacer clic y ejecutar (Protegido) Microsoft Office Klicka-och-kör 2010 (Skyddad) Microsoft Office Click-to-Run 2010 (มีการป้องกัน) Microsoft Office Tıklat-Çalıştır 2010 (Korunmuş) Microsoft Office Click-to-Run 2010 (захищено)

How to create the registry key that adds the label to the Q drive To apply the appropriate label to the Q: drive, a registry key must be set.

OEMs can create this key manually for non-MUI images and may develop their own solution to ensure that the appropriate label is applied for MUI OS images that permit the the end-user to make the UI language selection in OOBE. Alternatively OEMs may use a Microsoft developed tool shared under the Microsoft Public License (MsPL) at http://labelc2rdrive.codeplex.com which fully automates this process for MUI and non-MUI images.

Two suggestions how to add the label are described below: Suggestion 1: Manual steps: 1. While in system audit mode on the target system open regedit.

2. Using regedit add the following keys to the registry: Note: Replace “Microsoft Office Click-to-Run 2010 (Protected)� with the label matching the OS UI language.

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer\DriveIcons\Q\DefaultLabel Name=null value, Type=REG_SZ, Value=Microsoft Office Click-to-Run 2010 (Protected)

On a system pre-loaded with Windows Vista SP1 64bit or later the following additional registry needs to be added to ensure that the label is displayed in 32bit programs. This is not necessary on Windows 7 64bit as changes in WOW64 were made in that version.

HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Explorer\DriveIcons\Q\Defau ltLabel Name=null value, Type=REG_SZ, Value=Microsoft Office Click-to-Run 2010 (Protected)

Suggestion 2: Using the tool provided at http://labelc2rdrive.codeplex.com: 1. Download the tool from http://labelc2rdrive.codeplex.com.

Note that Microsoft provides both the binary (recommended) and the source code (in case OEMs want to modify/enhance the functionality) licensed under the terms of the Microsoft Public License (Ms-PL).

2. While in system audit mode on the target system extract the files from the downloaded .zip-file to c:\windows\setup\scripts\ . Please note that this directory does not exist by default and needs to be created.

3. The machine is now ready to be syspreped.

Technical details: SetupComplete.cmd gets launched automatically and with elevated rights after the OOBE phase of the Microsoft Windows setup is complete. SetupComplete.cmd will launch the labelc2rdrive.exe tool which detects the preferred system UI language and sets the correct matching label.

There is no output visible to the end-user during the OS OOBE and the complete process takes less than 1 second.

Questions and answers Q: What happens if the label registry key is set and the user never installs Microsoft Office 2010 Starter?

A: The drive label would not be visible to the end end-user.

Q: What if the end-user is using Q: for something else (network share, USB drive)? Would it get the label?

A: It depends. Mapped network shares and removeable drives (like USB drives) would not get the label, but fixed disks with the Q: drive letter assigned would.

Q: What can end-user do in case the label gets applied to fixed disk?

A: User can simply right-click on the drive in the Windows Explorer and select “Rename� to change or remove the drive label.

Screenshots Click-to-Run (C2R) drive prior to setting the registry key:

Click-to-Run (C2R) drive after setting the registry key for the en-US UI language: