Syntax

HRESULT Unpin(
  [in]  HWND hwndParent,
  [in]  LPCWSTR *rgpszPaths,
  [in]  ULONG cPaths,
  [in]  BOOL bDeep,
  [in]  BOOL bAsync,
  [in]  DWORD dwPinControlFlags,
  [in]  IOfflineFilesSyncProgress *pIProgress
);

Parameters

hwndParent [in]

Identifies the parent window for any user interface elements displayed. This parameter is ignored if the OFFLINEFILES_PIN_CONTROL_FLAG_INTERACTIVE flag is not set in the dwPinControlFlags parameter.

rgpszPaths [in]

Array of pointers, each to a fully qualified UNC path of a file or directory to be unpinned.

cPaths [in]

Number of paths in the rgpszPaths array.

bDeep [in]

If one or more of the paths provided refers to a directory or shared folder, this argument indicates whether all subdirectories are to be unpinned as well. If this parameter is TRUE, all subdirectories are unpinned recursively. If this parameter is FALSE, only files that are immediate children of the directory are unpinned.

bAsync [in]

Indicates if the operation is to be performed asynchronously. If this parameter is TRUE, the operation is scheduled for asynchronous operation and the function returns immediately. If this parameter is FALSE, the function returns when the operation is complete.

dwPinControlFlags [in]

Controls the behavior of the unpin operation. May be one or more of the following flags.

Value	Meaning
OFFLINEFILES_PIN_CONTROL_FLAG_FILL 0x00000001	Ignored when unpinning.
OFFLINEFILES_PIN_CONTROL_PINLINKTARGETS 0x00000010	Ignored when unpinning.
OFFLINEFILES_PIN_CONTROL_FLAG_FORUSER 0x00000020	Unpins the items for the calling user. This is the flag typically set for a caller of this function. It is important to note that Offline Files does not support a true per-user notion of pinning. When an item is pinned for a user, it is pinned for all users of that machine. However, the ability to access that pinned file depends on the user's access rights to that file computed while online.
OFFLINEFILES_PIN_CONTROL_FLAG_FORUSER_POLICY 0x00000040	Unpins the items for per-user policy. This differs from the "FORUSER" flag in that this flag cannot be modified by the user through the Offline Files user interface. Internally, Offline Files sets this flag when items are unpinned by its Group Policy extension.
OFFLINEFILES_PIN_CONTROL_FLAG_FORALL 0x00000080	Unpins the items for all users of the local machine. While the pinned state applies to all users, the ability to access a pinned file depends on the user's access rights to that file computed while online.
OFFLINEFILES_PIN_CONTROL_FLAG_FORREDIR 0x00000100	Unpins the items for purposes of folder redirection for the calling user. Windows Folder Redirection sets this flag when unpinning redirected folders.
OFFLINEFILES_PIN_CONTROL_FLAG_LOWPRIORITY 0x00000200	Reserved for future use.
OFFLINEFILES_PIN_CONTROL_FLAG_ASYNCPROGRESS 0x00000400	Progress is reported to the progress interface asynchronously with the actual operations. For more information about behavior, see the Asynchronous Progress Notifications section. If this flag is not set, progress is reported synchronously with each operation.
OFFLINEFILES_PIN_CONTROL_FLAG_INTERACTIVE 0x00000800	Set this flag if the operation is allowed to display user interface elements as necessary. An example is the system's credential-request dialog. If this flag is set, the value in hwndParent is used as the parent for any user interface elements displayed.
OFFLINEFILES_PIN_CONTROL_FLAG_CONSOLE 0x00001000	This flag is ignored if the "interactive" flag is not set. If the "interactive" flag is set, this flag indicates that any UI produced should be directed to the console window associated with the process invoking the operation.
OFFLINEFILES_PIN_CONTROL_FLAG_BACKGROUND 0x00010000	Set this flag if you want the unpin operation to avoid sharing violations in the event that an application wishes to open a file that is currently open for the pin operation. When that scenario occurs and this flag is set, the unpin operation will "back off" and not finish for that particular file at that time. This flag is primarily used by the Offline Files service for internal operations.

 

pIProgress [in]

Interface to an event sink that will receive progress events during the operation. If events are not desired, this parameter may be NULL.

Return Value

Returns S_OK if successful, or an error value otherwise.

Returns HRESULT_FROM_WIN32(ERROR_CANCELLED) if the operation is canceled.

Remarks

If a unpin operation involving multiple files is canceled while in progress, changes to files processed to that point are not rolled back.

If only one path is provided in the rgpszPaths parameter and that path is to a single file, the return value indicates the result of that single unpin operation. Otherwise, the caller must implement the progress callback methods in the following table and monitor the IOfflineFilesSyncProgress::SyncItemResult method to obtain the result for each processed file and directory.

Requirements

See Also

IOfflineFilesCache

Send comments about this topic to Microsoft

Build date: 6/18/2009