Select the product you need help with

Files that you add to the Offline Files folder on a Windows XP-based computer are synchronized when another person uses the computer

Article ID: 811660 -View products that this article applies to.

SYMPTOMS

If you add files to the Offline Files folder on a Microsoft Windows XP-based computer that is shared by more than one user, offline synchronization of those files will occur when another user logs on to that computer. Network shares and Web sites that require your security credentials cannot synchronize and will prompt other users to submit the correct credentials.

Back to the top Give Feedback

CAUSE

When you add files to the Offline Files folder, these files are synchronized whenever the computer connects to the network. Synchronization occurs when the computer connects to the network, not when a user logs on to the computer.

The Offline File folder cache is a mirror of the network file system. File access is based upon the same administrative credentials. Files on the network file system that grant access toeveryone and that have been added by a user to the Offline File folder will be synchronized, regardless of who logs on to the computer. Therefore, when a user connects to the network on a shared computer, that user must wait until all files in the Offline Files folder are synchronized, whether the user wants to synchronize those files or not.

Back to the top Give Feedback

RESOLUTION

Service pack information

To resolve this problem, obtain the latest service pack for Windows XP. For more information, click the following article number to view the article in the Microsoft Knowledge Base:

322389

(http://support.microsoft.com/kb/322389/ )

How to obtain the latest Windows XP service pack

Hotfix information

A supported hotfix is available from Microsoft. However, this hotfix is intended to correct only the problem that is described in this article. Apply this hotfix only to systems that are experiencing this specific problem. This hotfix might receive additional testing. Therefore, if you are not severely affected by this problem, we recommend that you wait for the next software update that contains this hotfix.

If the hotfix is available for download, there is a "Hotfix download available" section at the top of this Knowledge Base article. If this section does not appear, contact Microsoft Customer Service and Support to obtain the hotfix.

Note If additional issues occur or if any troubleshooting is required, you might have to create a separate service request. The usual support costs will apply to additional support questions and issues that do not qualify for this specific hotfix. For a complete list of Microsoft Customer Service and Support telephone numbers or to create a separate service request, visit the following Microsoft Web site:

http://support.microsoft.com/contactus/?ws=support

(http://support.microsoft.com/contactus/?ws=support)

Note The "Hotfix download available" form displays the languages for which the hotfix is available. If you do not see your language, it is because a hotfix is not available for that language.

The English version of this hotfix has the file attributes (or later file attributes) that are listed in the following table. The dates and times for these files are listed in Coordinated Universal Time (UTC). When you view the file information, it is converted to local time. To find the difference between UTC and local time, use theTime Zone tab in theDate and Time item in Control Panel.

Windows XP

Date         Time   Version          Size  File name----------------------------------------------------30-Dec-2002  08:20  5.1.2600.108  313,856  Cscui.dll

Windows XP Service Pack 1

Date         Time   Version           Size  File name-----------------------------------------------------31-Dec-2002  07:23  5.1.2600.1152  312,832  Cscui.dll

Back to the top Give Feedback

MORE INFORMATION

This hotfix includes four primary additions to OfflineFiles. To apply the additions that you want to use, you must edit the registry as directed in the section of this article that describes the specific addition. The four primary additions are:

Exclusion error suppression
Purge files for non-primary users at logoff
Prevent admin pinning of files for non-primary users
Forced silent auto reconnection

Only the Offline Files feature ofWindows XP uses these additions. Microsoft does not support or recommend any other use for these additions.

Exclusion error suppression

The Offline Files feature does not permit you to cache certain file types. This restriction prevents corruption of file sets and avoids conflicts withcompeting synchronization technologies. When you try to cache one of these file types, you may receive the following error message for each file:

Files of this type cannot be made available offline

This message is useful to users who are unfamiliar with the synchronization process. However, when users understand that certain file types cannot be cached, the message becomes an annoyance, because the message prevents thesynchronization progress dialog box from closing automatically at the end of synchronization. This hotfix introduces a new registry key that prevents subsets of these files from generating this specific synchronization error. After you apply this hotfix, you must edit the registry and enter the appropriate file specification for the following registry subkeys:

HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\NetCache\ExclusionErrorSuppressionList
HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\NetCache\ExclusionErrorSuppressionList

These subkeys can contain zero or more values. The values are known as "file specifications."

At runtime, the lists under these two registry subkeys are merged into a singlelist. One list does not take precedence over the other. An empty key and a missing key are treated in the same way. An empty key and a missing key each produce a list of zero items.

File specifications

The file specifications that you add to the new

ExclusionErrorSuppressionList

keys are Universal Naming Convention (UNC) path strings. These path strings may incorporate a wildcard character (asterisk) to indicate “match any” at that particular position in the specification.

Each file specification uses the following format:

\\Server\Share\Folder\Filename.extension

You can include environment variables, such as the variable%username%, in a specification. A variable is expanded at runtime to the equivalent text value.

You can substitute the wildcard character for any part of the file specification and for the folder designation. For example,

\\corpsvr\staff\%username%\documents\*\*.doc

However, you cannot substitute the wildcard character for a folder that is followed by another folder name. For example, the followingspecification is not valid:

\\corpsvr\staff\%username%\documents\*\personal\*.doc

This specification is rejected because the specification embeds a wildcard character between the folder names %username% and personal.

NoteWindows XP does not recognize invalid specifications and does not log invalid specifications anywhere in the system. Window XP ignores invalid specifications at runtime.

Examples of the file specifications are:

\\*\*\*\*.dbf
This example suppresses the specification error for any file with the extension .dbf in any folder, on any share, and from any server.
\\Server\*\*\*.dbf
This example suppresses the specification error for any file with the extension .dbf in any folder and on any share on the specified server.
\\Server\\*\*\*\Test.dbf
This example suppresses the specification error for any file with the name "Test.dbf" in any folder, on any share, and from any server.
\\Server\Share\Folder\Test.dbf
This example suppresses the specification error for a specific file with the name "Test.dbf".
\\Server\Share\*\*.*
This example suppresses any file in any folder on the specified share from the specified server.
\\Server\Share\%username%\*\Test.dbf
This example suppresses files with the name "Test.dbf" in any user’s home folder that is defined by the environment variable %username%.

To add the ExclusionErrorSuppressionList registry keys and to enter the file specifications that you want, follow these steps after you apply the hotfix.

Important This section, method, or task contains steps that tell you how to modify the registry. However, serious problems might occur if you modify the registry incorrectly. Therefore, make sure that you follow these steps carefully. For added protection, back up the registry before you modify it. Then, you can restore the registry if a problem occurs. For more information about how to back up and restore the registry, click the following article number to view the article in the Microsoft Knowledge Base:

322756

(http://support.microsoft.com/kb/322756/ )

How to back up and restore the registry in Windows

ClickStart, clickRun, typeregedit, and then clickOK.
Locate and click the following registry subkey:
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\NetCache
ClickEdit, point toNew, and then clickKey.
TypeExclusionErrorSuppressionList, and then press ENTER to name the new key.
Click
ExclusionErrorSuppressionList
, clickEdit, point toNew, and then clickDWORD Value.
Type the file specification that you want to use, and then press ENTER to name the value.
Repeat steps 5 through 6 for each file specification that you want to use.

System behavior

When the synchronization process encounters a file that is on the exclusion list, the file’s complete path is tested against the list of filespecifications that are read from the registry. If the file's path matches any one of the specifications, the "files of this type cannot be madeavailable offline" error message does not appear in thesynchronization progress dialog. Windows XP does not record the suppression of this error message.

Purge files for non-primary users at logoff

When a user briefly logs onto a computer that is not the user's regularworkplace computer, and the user caches files from the network, either by autocaching or by pinning, those files remain in the cache on that computer until the files are removed.

The feature changes that are included in this hotfix introduce a new registry key that designates users of a computer as eitherprimary ornon-primary. With thisdesignation, files that are cached for a non-primary user can be removed from the cache when the user logs off. This registry key contains zero or more values, and each value name designates auser account that will be considered primary by the Offline Filesfeature. Each value name may take one of the following forms:

A user account name, such asmydomain\username
A user account security ID (SID) in text form, such as S-1-5-21-397955417-626881126-188441444-2201386

The data value and the value type for each registry entry are ignored, and only the value name is used.

Windows XP uses the following process to determine if a computer user is a primary or a non-primary user:

At runtime, Windows XP obtains the current user’s SID from the user’ssecurity token.
If the registry entry is provided as a SID string, Windows XP converts that string to a binary SID and compares the string to the current user’s SID. If the registry entry is providedas an account name, the Win32 APILookupAccountName function queries the security authority for that account's SID.
The SID is then compared with the current user’s SID.
If a match is found in the list of primary users that is read from the registry, the currentuser is considered a primary user. If no registry entries exist or no match is found, the user is considered a non-primary user.Windows XP ignores invalid entries in this registry key. and does not create a systemlog entry to identify invalid entries.

Note This list of primary users affects only the Offline Files feature. No other Windows component uses this list, and Microsoft does not support any otheruse of this list.

To apply this feature change, follow these steps:

ClickStart, clickRun, typeregedit, and then clickOK.
Locate and click the following registry subkey:
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\NetCache
ClickEdit, point toNew, and then clickKey.
TypePrimaryUsers, and then press ENTER to name the new key.
Click
PrimaryUsers
, clickEdit, point toNew, and then clickDWORD Value.
Use one of the following formats to type a user name:
- domain\username
- S-1-5-21-397955417-626881126-188441444-2201386
  This is a user account security ID (SID) in text form.
Click
NetCache
, clickEdit, point toNew, and then clickDWORD Value.
TypePurgeNonPrimaryUserFilesAtLogoff, and then press ENTER to name the value.
Double-click
PurgeNonPrimaryUserFilesAtLogoff
.
In theValue databox, type1, and then clickOK.

WarningYou must coordinate the addition of this registry key with the existingPurgeAtLogoff system policy. This policy is activated in Group Policy through thefollowing path:

Computer Configuration\Administrative Templates\Network\Offline Files\At logoff, delete local copy of user’s offline files

If you enable this policy, the PurgeNonPrimaryUserFilesAtLogoff registry value is ignored, and files for non-primary users will not be removed.

Note

You must use the AdminPinForPrimaryUsersOnly registry setting. (See the "Prevent admin pinning of files for non-primary users" section.) If the AdminPinForPrimaryUsersOnly registry setting does not exist, and admin pinning is in progress whenthe non-primary user logs off, a race condition occurs and adminpinning continues to run after files have been removed from thecache. Therefore, after logoff, files may becached for the non-primary user. The solution is to disable admin pinning for non-primary users by using the AdminPinForPrimaryUsersOnly registry entry.
Because the selection of files for deletion is based on user access to those files, and because Client Side Caching (CSC) does not cache securityinformation for folder entries in Windows 2000 and Windows XP, an emptyfolder entry that has been pinned by another user may be removed from the cache. However, if the cached folder contains any cached subdirectories or files, the folder will not be removed.
Autocaching occurs when any process on the computer opens a file on a remote share that is marked for autocaching. Files that are deleted may be replaced before the logoff sequence is completed. If this is a problem, you may want to disable autocaching on shares that host these redirected shell special folders. For example, you might disable autocaching on the My Pictures, My Music, and My Videos folders.
If you enable the
PrimaryUsers
registry key and a non-primary user is logged on, when the non-primary user makes offline changes to any cached files, those modified files are not removed from the cache during the deletion process. This scenario preserves any potentially valuable offline content. Therefore, some files that are cached by the non-primary user may remain on the local computer after the user logs off.

Prevent admin pinning of files for non-primary users

A user who has been assigned offline files for administrative purposes caches content on every computer the user logs on to. This scenario may cause unwanted content to be cached on some computers. To prevent this scenario, this hotfix introduces a modification to the processing of admin pinning. With this hotfix, admin pinning does not override the primary user list that is described in the "Purge files for non-primary users at logoff" section. If the current user is not in the primary users list, per-user admin pinning will not occur for that user on the current computer. To prevent per-user admin pinning for non-primary users, follow these steps:

ClickStart, clickRun, typeregedit, and then clickOK.
Locate and click the following registry subkey:
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\NetCache
ClickEdit, point toNew, and then clickDWORD Value.
TypeAdminPinForPrimaryUsersOnly, and then press ENTER to name the value.
Double-click
AdminPinForPrimaryUsersOnly
.
In theValue databox, type1, and then clickOK.

Forced silent auto reconnection

When a server has been unavailable (offline mode) and then becomes available again forconnection, Offline Files Client Side Caching tries to transition that server to online mode if all the following conditions are true:

There are no offline changes for that server on the local computer.
There are no open file handles for that server on the localcomputer.
The server is accessed over a “fast” link. You can adjust the definitionof “slow” and “fast” by using theSlowLinkSpeed Offline Files policy.

With this hotfix, you can configure Offline Files Client Side Caching to ignore these conditions andtransition the server to online mode regardless of whether these conditions exist. To do this, follow these steps:

ClickStart, clickRun, typeREGEDIT, and then clickOK.
Locate and click the following registry subkey:
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\NetCache
ClickEdit, point toNew, and then clickDWORD Value.
TypeSilentForcedAutoReconnect, and then press ENTER to name the value.
Double-click
SilentForcedAutoReconnect
.
In theValue databox, type1, and then clickOK.

Note After you apply this hotfix, the following behavior may occur:

Any offline changes will remain unsynchronized and unavailableuntil the changes are synchronized in the future. This situation causes a dirty cache conditionthat is announced through a small warning overlay image on the Offline Files icon in the notification area.
Any open handles to files that are cached on the associated server will be automatically closed and invalidated. This action may cause problems if the programs that are using those files cannot work gracefully with invalid file handles.
If the server is available over a slow network link, such as a satellite link or a telephone line, the server will still be transitioned online. This scenario may cause very slow access to the remote file system on the server from the local computer.

Back to the top Give Feedback

STATUS

Microsoft has confirmed that this is a problem in the Microsoft products that are listed in the "Applies to" section. This problem was first corrected in Microsoft Windows XP Service Pack 2.

Back to the top Give Feedback