SHAddToRecentDocs

This function adds a document to the shell’s list of recently used documents or clears all documents from the list. The user gains access to the list through the Start menu of a taskbar or other top-level application.

At a Glance

Header file: Shellapi.h
Windows CE versions: 1.0 and later

Syntax

WINSHELLAPI void WINAPI SHAddToRecentDocs(UINT uFlags, LPCVOID pv);

Parameters

uFlags

[in] Flag that indicates the meaning of the pv parameter. It is one of the following values:

Value Description
SHARD_PATH The pv parameter contains the address of a path string.
SHARD_PIDL The pv parameter contains the address of an item identifier list (PIDL) that identifies a file object. PIDLs that identify nonfile objects are not allowed.

pv

[in] Void pointer to a character buffer that contains the path and file name of the document, or the address of an ITEMIDLIST structure that contains an item identifier list that uniquely identifies the document. If this parameter is NULL, the function clears all documents from the list.

Return Values

None.

Remarks

In Windows CE, you cannot add more than ten documents to the recently used documents list.