Shell Functions


Shell Functions

This section describes the Microsoft Windows Shell functions.

AddMRUStringW

Adds a string to the top of the most recently used (MRU) list.

AssocCreateForClasses

Retrieves an object that implements an IQueryAssociations interface.

AssocGetDetailsOfPropKey

Retrieves the value for a given property key using the file association information provided by the Namespace Extensions.

CallCPLEntry16

Performs no function. Provided for backward compatibility.

CanShareFolderW

Used to determine whether to show the Share this folder option in Web view.

CDefFolderMenu_Create2

Creates a context menu for a selected group of file folder objects.

CIDLData_CreateFromIDArray

Creates a data object with the default vtable pointer.

CIShutdown

Shuts down the content indexer and closes all open catalogs.

CommandLineToArgvW

Parses a Unicode command line string and returns an array of pointers to the command line arguments, along with a count of such arguments, in a way that is similar to the standard C run-time argv and argc values.

CPlApplet

Serves as the entry point for a Control Panel application. This is a library-defined callback function.

CreateEnvironmentBlock

Retrieves the environment variables for the specified user. This block can then be passed to the CreateProcessAsUser function.

CreateHardwareEventMoniker

Creates a moniker representing a hardware component and its associated event handler. AutoPlay uses this function to allow applications to use AutoPlay events.

CreateMRUListW

Creates a new MRU list.

CreateProfile

Creates a new user profile.

CreateUserProfileEx

Creates a user profile for a specified user.

Note  This function is not available in Windows Vista and later versions.
CscSearchApiGetInterface

Creates an instance of a CCscSearchApiInterface object.

DAD_AutoScroll

Scrolls the window while an image is being dragged.

DAD_DragEnterEx

Locks updates to the specified window during a drag operation and displays the drag image at the specified position within the window.

DAD_DragEnterEx2

Locks updates to the specified window during a drag-and-drop operation and displays the drag image at the specified position within the window.

DAD_DragLeave

Unlocks the window locked by the DAD_DragEnterEx function.

DAD_DragMove

Moves the image that is being dragged during a drag-and-drop operation.

DAD_SetDragImage

Sets the drag image.

DAD_ShowDragImage

Shows or hides the image being dragged.

DefScreenSaverProc

Provides default processing for any messages that a screen saver application does not process.

DefSubclassProc

Calls the next handler in a window's subclass chain. The last handler in the subclass chain calls the original window procedure for the window.

DeleteProfile

Deletes the user profile and all user-related settings from the specified computer. The caller must have administrative privileges to delete a user's profile.

DestroyEnvironmentBlock

Frees environment variables created by the CreateEnvironmentBlock function.

DllGetVersion

Implemented by many of the Windows Shell DLLs to allow applications to obtain DLL-specific version information.

DoEnvironmentSubst

Parses an input string containing references to one or more environment variables and replaces them with their current values.

DragAcceptFiles

Registers whether a window accepts dropped files.

DragFinish

Releases memory that the system allocated for use in transferring file names to the application.

DragQueryFile

Retrieves the names of dropped files that result from a successful drag-and-drop operation.

DragQueryPoint

Retrieves the position of the mouse pointer at the time a file was dropped during a drag-and-drop operation.

DriveType

Determines the drive type based on the drive number.

DuplicateIcon

Creates a duplicate of a specified icon.

EnumMRUListW

Enumerates the contents of the MRU list. Optionally retrieves an item from the enumeration.

EstimateFileRiskLevel

Estimates the risk of executing unknown code when a handler is called on a given file. This risk is based on an understanding of the handler and the code content of the file.

ExpandEnvironmentStringsForUser

Expands the source string by using the environment block established for the specified user.

ExtractAssociatedIcon

Gets a handle to an icon stored as a resource in a file or an icon stored in a file's associated executable file.

ExtractAssociatedIconEx

Gets a handle to an icon stored as a resource in a file or an icon stored in a file's associated executable file. It extends the ExtractAssociatedIcon function by retrieving the icon's ID when that icon is extracted from an executable file.

ExtractIcon

Gets a handle to an icon from the specified executable file, DLL, or icon file.

To retrieve an array of handles to large or small icons, use the ExtractIconEx function.

ExtractIconEx

The ExtractIconEx function creates an array of handles to large or small icons extracted from the specified executable file, DLL, or icon file.

FileIconInit

Initializes or reinitializes the system image list.

FindExecutable

Retrieves the name of and handle to the executable (.exe) file associated with a specific document file.

FreeConfirmConflictItem

Frees the resources that have been allocated for a CONFIRM_CONFLICT_ITEM structure.

FreeIDListArray

Frees the memory used by an pointer to an item identifier list (PIDL) list array.

FreeIDListArrayChild

Releases the memory space for the array of pointers to child item IDs. This releases both the PITEMID_CHILDs within the array and the array itself.

FreeIDListArrayFull

Releases the memory space for the PIDL array. This releases both the PIDLIST_ABSOLUTEs within the array and the array itself.

FreeKnownFolderDefinitionFields

Frees the allocated fields in the result from IKnownFolder::GetFolderDefinition.

FreeMRUList

Frees the handle associated with the MRU list and writes cached data to the registry.

GetAllUsersProfileDirectory

Retrieves the path to the root of the All Users profile.

GetCurrentProcessExplicitAppUserModelID

Retrieves the application-defined, explicit Application User Model ID (AppUserModelID) for the current process.

GetDefaultUserProfileDirectory

Retrieves the path to the root of the Default User profile.

GetFileNameFromBrowse

Creates an Open dialog box so that the user can specify the drive, directory, and name of a file to open.

GetMenuContextHelpId

Retrieves the Help context identifier associated with the specified menu.

GetProfilesDirectory

Retrieves the path to the root directory where all user profiles are stored.

GetProfileType

Retrieves the type of profile loaded for the current user.

GetUserProfileDirectory

Retrieves the path to the root directory of the specified user's profile.

GetWindowContextHelpId

Retrieves the Help context identifier, if any, associated with the specified window.

GetWindowSubclass

Retrieves the reference data for the specified window subclass callback.

GUIDFromString

Deprecated. Converts a string to a GUID.

Note  Applications should use CLSIDFromString or IIDFromString in place of this function.
ILAppendID

Appends or prepends an SHITEMID structure to an ITEMIDLIST structure.

ILClone

Clones an ITEMIDLIST structure.

ILCloneChild

Clones a child ITEMIDLIST structure.

ILCloneFirst

Clones the first SHITEMID structure in an ITEMIDLIST structure.

ILCloneFull

Clones a full, or absolute, ITEMIDLIST structure.

ILCombine

Combines two ITEMIDLIST structures.

ILCreateFromPath

Returns the ITEMIDLIST structure associated with a specified file path.

ILFindChild

Determines whether a specified ITEMIDLIST structure is the child of another ITEMIDLIST structure.

ILFindLastID

Returns a pointer to the last SHITEMID structure in an ITEMIDLIST structure.

ILFree

Frees an ITEMIDLIST structure allocated by the Shell.

ILGetNext

Retrieves the next SHITEMID structure in an ITEMIDLIST structure.

ILGetSize

Returns the size, in bytes, of an ITEMIDLIST structure.

ILIsAligned

Verifies whether a constant ITEMIDLIST is aligned on a pointer boundary, which is a DWORD on 32-bit architectures and a QWORD on 64-bit architectures.

ILIsChild

Verifies whether a PIDL is a child PIDL, which is a PIDL with exactly one SHITEMID.

ILIsEmpty

Verifies whether an ITEMIDLIST structure is empty.

ILIsEqual

Tests whether two ITEMIDLIST structures are equal in a binary comparison.

ILIsParent

Tests whether an ITEMIDLIST structure is the parent of another ITEMIDLIST structure.

ILLoadFromStream

Deprecated. Loads an ITEMIDLIST structure from a stream.

ILLoadFromStreamEx(IStream*, PIDLIST_ABSOLUTE*)

Loads an absolute ITEMIDLIST from an IStream.

ILLoadFromStreamEx(IStream*, PIDLIST_RELATIVE*)

Loads an ITEMIDLIST from an IStream.

ILLoadFromStreamEx(IStream*, PITEMID_CHILD*)

Loads a child PIDL from an IStream.

ILNext(PCUIDLIST_RELATIVE)

Retrieves the next SHITEMID structure in an ITEMIDLIST structure.

ILNext(PUIDLIST_RELATIVE)

Retrieves the next SHITEMID structure in an ITEMIDLIST structure.

ILRemoveLastID

Removes the last SHITEMID structure from an ITEMIDLIST structure.

ILSaveToStream

Saves an ITEMIDLIST structure to a stream.

ILSkip(PCUIDLIST_RELATIVE, UINT)

Skips a given number of bytes in a constant, unaligned, relative ITEMIDLIST structure.

ILSkip(PUIDLIST_RELATIVE, UINT)

Skips a given number of bytes in an unaligned, relative ITEMIDLIST structure.

InetIsOffline

Determines whether the system is connected to the Internet.

InitNetworkAddressControl

Initializes the network address control window class.

InitPropVariantFromGUIDAsBuffer

Initializes a PROPVARIANT structure based on a GUID. The structure is initialized as VT_VECTOR | VT_UI1.

InitPropVariantFromGUIDAsString

Initializes a PROPVARIANT structure based on a GUID. The structure is initialized as VT_LPWSTR.

InitVariantFromGUIDAsBuffer

Initializes a VARIANT structure based on a GUID. The structure is initialized as VT_ARRAY | VT_UI1.

InitVariantFromGUIDAsString

Initializes a VARIANT structure based on a GUID. The structure is initialized as VT_BSTR.

IsNetDrive

Tests whether a drive is a network drive.

IsUserAnAdmin

Tests whether the current user is a member of the Administrator's group.

LinkWindow_RegisterClass

Registers a window class that allows for the SysLink common control to be used in a window.

LinkWindow_UnregisterClass

Unregisters a window class registered by LinkWindow_RegisterClass.

LoadUserProfile

Loads the specified user's profile. The profile can be a local user profile or a roaming user profile.

MIMEAssociationDialog

Runs the unregistered MIME content type dialog box.

Note  Windows XP Service Pack 2 (SP2) or later: This function is no longer supported.
NTSHChangeNotifyDeregister

Unregisters the client's window process from receiving SHChangeNotify. This is the equivalent of calling the SHChangeNotifyDeregister function.

NTSHChangeNotifyRegister

Registers a window that receives notifications from the file system or Shell. Notifications that are received will use shared memory, equivalent to calling SHChangeNotifyRegister with the SHCNRF_NewDelivery flag set.

OpenRegStream

Opens a registry value and supplies an IStream interface that can be used to read from or write to the value.

ParseField

Reads a line from Setup.inf and extracts the specified field from the string.

PassportWizardRunDll

Launches the Passport Wizard when used with Rundll32.exe.

PathCleanupSpec

Removes illegal characters from a file or directory name. Enforces the 8.3 filename format on drives that do not support long file names.

PathGetShortPath

Retrieves the short path form of a specified input path.

PathIsExe

Determines whether a file is an executable by examining the file extension.

PathIsSlow

Determines whether a file path is a high-latency network connection.

PathMakeUniqueName

Creates a unique path name from a template.

PathProcessCommand

Deprecated. Processes a string that contains a command line and generates a suitably quoted string, with arguments attached if required.

PathResolve

Converts a relative or unqualified path name to a fully-qualified path name.

PathYetAnotherMakeUniqueName

Creates a unique filename based on an existing filename.

PerUserInit

Creates My Documents and other special folders, initializes them as needed, and creates the Send To shortcut menu item for My Documents.

PickIconDlg

Displays a dialog box that allows the user to choose an icon from the selection available embedded in a resource such as an executable or DLL file.

PifMgr_CloseProperties

Closes application properties that were opened with PifMgr_OpenProperties.

PifMgr_GetProperties

Returns a specified block of data from a .pif file.

PifMgr_OpenProperties

Opens the .pif file associated with a Microsoft MS-DOS application, and returns a handle to the application's properties.

PifMgr_SetProperties

Assigns values to a block of data from a .pif file.

PSCoerceToCanonicalValue

Converts the value to the canonical value, according to the property description.

PSCreateAdapterFromPropertyStore

Creates an adapter from an IPropertyStore.

PSCreateDelayedMultiplexPropertyStore

Creates a read-only, delayed-binding property store that contains multiple property stores.

PSCreateMemoryPropertyStore

Creates an in-memory property store.

PSCreateMultiplexPropertyStore

Creates a read-only property store that contains multiple property stores, each of which must support either IPropertyStore or IPropertySetStorage.

PSCreatePropertyChangeArray

Creates a container for a set of IPropertyChange objects. This container can be used with IFileOperation to apply a set of property changes to a set of files.

PSCreatePropertyStoreFromObject

Accepts the IUnknown of an object that supports IPropertyStore or IPropertySetStorage. If the object supports IPropertySetStorage, it is wrapped so that it supports IPropertyStore.

PSCreatePropertyStoreFromPropertySetStorage

Creates a property store with an IPropertySetStorage.

PSCreateSimplePropertyChange

Creates a simple property change.

PSEnumeratePropertyDescriptions

A wrapper API that calls the schema subsystem's IPropertySystem::EnumeratePropertyDescriptions. This function retrieves an instance of the subsystem object that implements IPropertyDescriptionList, in order to obtain either the entire or a partial list of property descriptions in the system.

PSFormatForDisplay

Gets a formatted, Unicode string representation of a property value stored in a PROPVARIANT structure. The caller is responsible for allocating the output buffer.

PSFormatForDisplayAlloc

Gets a formatted, Unicode string representation of a property value stored in a PROPVARIANT structure. This function allocates memory for the output string.

PSFormatPropertyValue

Gets a formatted, Unicode string representation of a property value stored in a property store. This function allocates memory for the output string.

PSGetImageReferenceForValue

Gets an instance of a property description interface for a specified property.

PSGetItemPropertyHandler

Retrieves a property handler for a Shell item.

PSGetItemPropertyHandlerWithCreateObject

Retrieves a property handler for a Shell item. Also allows the option of

PSGetNamedPropertyFromPropertyStorage

Gets a value from serialized property storage by property name.

PSGetNameFromPropertyKey

Retrieves the canonical name of the property, given its PROPERTYKEY.

PSGetPropertyDescription

Gets an instance of a property description interface for a property specified by a given PROPERTYKEY structure.

PSGetPropertyDescriptionByName

Gets an instance of a property description interface for a specified property name.

PSGetPropertyDescriptionListFromString

Gets an instance of a property description list interface for a specified property list.

PSGetPropertyFromPropertyStorage

Gets the value of a property as stored in serialized property storage.

PSGetPropertyKeyFromName

Gets the property key for a given canonical property name.

PSGetPropertySystem

Gets an instance of the subsystem object that implements IPropertySystem.

PSGetPropertyValue

Gets a property value from a property store.

PSLookupPropertyHandlerCLSID

Gets the class identifier (CLSID) of a per-computer, registered file property handler.

PSPropertyBag_Delete

Deletes a given property stored in a property bag.

PSPropertyBag_ReadBOOL

Reads the BOOL data value of a given property in a property bag.

PSPropertyBag_ReadBSTR

Reads the value of the BSTR data value of a given property in a property bag.

PSPropertyBag_ReadDWORD

Reads the DWORD data value of a given property in a property bag.

PSPropertyBag_ReadGUID

Reads the GUID data value of a given property in a property bag.

PSPropertyBag_ReadInt

Reads the int data value of a given property in a property bag.

PSPropertyBag_ReadLONG

Reads the long data value of a given property in a property bag.

PSPropertyBag_ReadPOINTL

Retrieves the coordinates stored in a given property contained in a specified property bag.

PSPropertyBag_ReadPOINTS

Retrieves the coordinates stored in a given property contained in a specified property bag.

PSPropertyBag_ReadPropertyKey

Reads the property key of a given property in the property bag.

PSPropertyBag_ReadRECTL

Retrieves the coordinates stored in a given property contained in a specified property bag.

PSPropertyBag_ReadSHORT

Reads the SHORT data value of a given property in a property bag.

PSPropertyBag_ReadStr

Reads the string data value of a given property in a property bag.

PSPropertyBag_ReadStrAlloc

Retrieves details about a string's allocation or deallocation of memory stored in a given property contained in a specified property bag.

PSPropertyBag_ReadStream

Reads the data stream stored in a given property contained in a specified property bag.

PSPropertyBag_ReadType

Reads the type of data value of a property that is stored in a property bag.

PSPropertyBag_ReadULONGLONG

Reads the ULONGLONG data value of a given property in a property bag.

PSPropertyBag_ReadUnknown

Reads a given property of an unknown data value in a property bag.

PSPropertyBag_WriteBOOL

Saves the BOOL data value of a given property in a property bag.

PSPropertyBag_WriteBSTR

Saves the value of the BSTR data value of a given property in a property bag.

PSPropertyBag_WriteDWORD

Saves the DWORD data value of a given property in a property bag.

PSPropertyBag_WriteGUID

Saves the GUID data value of a given property in a property bag.

PSPropertyBag_WriteInt

Saves the int data value of a given property in a property bag.

PSPropertyBag_WriteLONG

Saves the long data value of a given property in a property bag.

PSPropertyBag_WritePOINTL

Saves the coordinates stored in a given property contained in a specified property bag.

PSPropertyBag_WritePOINTS

Saves the coordinates stored in a given property contained in a specified property bag.

PSPropertyBag_WritePropertyKey

Saves the property key of a given property in the property bag.

PSPropertyBag_WriteRECTL

Saves the coordinates stored in a given property contained in a specified property bag.

PSPropertyBag_WriteSHORT

Saves the SHORT data value of a given property in a property bag.

PSPropertyBag_WriteStr

Saves the string data value of a given property in a property bag.

PSPropertyBag_WriteStream

Saves the data stream of a property that is stored in the property bag.

PSPropertyBag_WriteULONGLONG

Saves the ULONGLONG data value of a given property in a property bag.

PSPropertyBag_WriteUnknown

Reads a given property of an unknown data value in a property bag.

PSPropertyKeyFromString

Converts a string to a PROPERTYKEY structure.

PSRefreshPropertySchema

Not currently supported.

PSRegisterPropertySchema

Informs the schema subsystem of the addition of a property description schema file.

PSSetPropertyValue

Sets the value of a property in a property store.

PSStringFromPropertyKey

Creates a string that identifies a property from that property's key.

PSUnregisterPropertySchema

Informs the schema subsystem of the removal of a property description schema file.

ReadCabinetState

Fills a CABINETSTATE structure with information from the registry.

RealDriveType

Determines the drive type based on the drive number.

RegisterDialogClasses

Registers any nonstandard window classes required by a screen saver's configuration dialog box.

RemoveWindowSubclass

Removes a subclass callback from a window.

RestartDialog

Displays a dialog box that prompts the user to restart Windows. When the user clicks the button, the function calls ExitWindowsEx to attempt to restart Windows.

RestartDialogEx

Displays a dialog box that asks the user to restart Windows. When the user clicks the button, the function calls ExitWindowsEx to attempt to restart Windows.

ScreenSaverConfigureDialog

Receives messages sent to a screen saver's configuration dialog box. A screen saver that allows user configuration must define this function.

ScreenSaverProc

Receives messages sent to the specified screen saver window.

SetCurrentProcessExplicitAppUserModelID

Specifies a unique application-defined AppUserModelID that identifies the current process to the taskbar. This identifier allows an application to group its associated processes and windows under a single taskbar button.

SetMenuContextHelpId

Associates a Help context identifier with a menu.

SetWindowContextHelpId

Associates a Help context identifier with the specified window.

SetWindowSubclass

Installs or updates a window subclass callback.

SHAddDefaultPropertiesByExt

Adds default properties to the property store as registered for the specified file extension.

SHAddFolderPathToLibrary

Adds a folder to a library.

SHAddFromPropSheetExtArray

Adds pages to a property sheet extension array created by SHCreatePropSheetExtArray.

SHAddToRecentDocs

Notifies the system that an item has been accessed, for the purposes of tracking those items used most recently and most frequently. This function can also be used to clear all usage data.

SHAlloc

Allocates memory from the Shell's heap.

SHAllocShared

Allocates a handle in a specified process to a copy of a specified memory block in the calling process.

SHAppBarMessage

Sends an appbar message to the system.

SHAssocEnumHandlers

Returns an enumeration object for a specified set of file extension handlers.

SHAssocEnumHandlersForProtocolByApplication

Gets an enumeration interface that provides access to handlers associated with a given protocol.

SHBindToFolderIDListParent

Given a Shell namespace item specified in the form of a folder, and an item identifier list relative to that folder, this function binds to the parent of the namespace item and optionally returns a pointer to the final component of the item identifier list.

SHBindToFolderIDListParentEx

Extends the SHBindToFolderIDListParent function by allowing the caller to specify a bind context.

SHBindToObject

Retrieves and binds to a specified object by using the Shell namespace IShellFolder::BindToObject method.

SHBindToParent

Takes a pointer to a fully-qualified item identifier list (PIDL), and returns a specified interface pointer on the parent object.

SHBrowseForFolder

Displays a dialog box that enables the user to select a Shell folder.

SHChangeNotification_Lock

Locks the shared memory associated with a Shell change notification event.

SHChangeNotification_Unlock

Unlocks shared memory for a change notification.

SHChangeNotify

Notifies the system of an event that an application has performed. An application should use this function if it performs an action that may affect the Shell.

SHChangeNotifyDeregister

Unregisters the client's window process from receiving SHChangeNotify.

SHChangeNotifyRegister

Registers a window that receives notifications from the file system or Shell.

SHChangeNotifyRegisterThread

Enables asynchronous register and deregister of a thread.

SHCloneSpecialIDList

Retrieves a pointer to the ITEMIDLIST structure that specifies a special folder.

SHCLSIDFromString

Takes the string form of a CLSID and creates the corresponding CLSID.

SHCoCreateInstance

Creates Component Object Model (COM) objects that are implemented in Shell32.dll.

SHCreateAssociationRegistration

Creates an IApplicationAssociationRegistration object based on the stock implementation of the interface provided by Windows.

SHCreateDataObject

Creates a data object in a parent folder.

SHCreateDefaultContextMenu

Creates an object that represents the Shell's default context menu implementation.

SHCreateDefaultExtractIcon

Creates a standard icon extractor, whose defaults can be further configured via the IDefaultExtractIconInit interface.

SHCreateDefaultPropertiesOp

Creates a file operation that sets the default properties on the Shell item that have not already been set.

SHCreateDirectory

Creates a folder.

SHCreateDirectoryEx

Creates a new file system folder.

SHCreateFileExtractIcon

Creates a default IExtractIcon handler for a file system object. Namespace extensions that display file system objects typically use this function. The extension and file attributes derive all that is needed for a simple icon extractor.

SHCreateItemFromIDList

Creates and initializes a Shell item object from a PIDL. The resulting shell item object supports the IShellItem interface.

SHCreateItemFromParsingName

Creates and initializes a Shell item object from a parsing name.

SHCreateItemFromRelativeName

Creates and initializes a Shell item object from a relative parsing name.

SHCreateItemInKnownFolder

Creates a Shell item object for a single file that exists inside a known folder.

SHCreateItemWithParent

Create a Shell item, given a parent folder and a child item ID.

SHCreateLibrary

Creates an IShellLibrary object.

SHCreateProcessAsUserW

Creates a new user-mode process and its primary thread to run a specified executable file.

Note  SHCreateProcessAsUserW is not implemented under Windows XP or later systems.
SHCreatePropSheetExtArray

Loads all the Shell property sheet extension handlers located under a specified registry key.

SHCreateQueryCancelAutoPlayMoniker

Creates a QueryCancelAutoPlay class moniker, which can then be used to register the IQueryCancelAutoPlay handler in the running object table (ROT).

SHCreateShellFolderView

Creates a new instance of the default Shell folder view object.

SHCreateShellFolderViewEx

Creates a new instance of the default Shell folder view object. It is recommended that you use SHCreateShellFolderView rather than this function.

SHCreateShellItem

Creates an IShellItem object.

Note  It is recommended that you use SHCreateItemWithParent or SHCreateItemFromIDList instead of this function.
SHCreateShellItemArray

Creates a Shell item array object.

SHCreateShellItemArrayFromDataObject

Creates a Shell item array object from a data object.

SHCreateShellItemArrayFromIDLists

Creates a Shell item array object from a list of ITEMIDLIST structures.

SHCreateShellItemArrayFromShellItem

Creates an array of one element from a single Shell item.

SHCreateStdEnumFmtEtc

Creates an IEnumFORMATETC object from an array of FORMATETC structures.

SHDefExtractIcon

Provides a default handler to extract an icon from a file.

SHDestroyPropSheetExtArray

Frees property sheet handlers that are pointed to an array created by SHCreatePropSheetExtArray.

SHDoDragDrop

Executes a drag-and-drop operation. Supports drag source creation on demand, as well as drag images.

Shell_GetCachedImageIndex

Retrieves the cache index of a cached icon.

Shell_GetImageLists

Retrieves system image lists for large and small icons.

Shell_MergeMenus

Merges two menus.

Shell_NotifyIcon

Sends a message to the taskbar's status area.

Shell_NotifyIconGetRect

Gets the screen coordinates of the bounding rectangle of a notification icon.

ShellAbout

Displays a ShellAbout dialog box.

ShellDDEInit

Registers the Shell Dynamic Data Exchange (DDE) services in the current process, notifying the system that the current process wishes to host DDE objects.

ShellExecute

Performs an operation on a specified file.

ShellExecuteEx

Performs an operation on a specified file.

ShellMessageBox

ShellMessageBox is a special instance of MessageBox that provides the option of using the owner window's title as the title of the message box.

SHEmptyRecycleBin

Empties the Recycle Bin on the specified drive.

SHEnumerateUnreadMailAccounts

Enumerates the user accounts that have unread e-mail.

SHEvaluateSystemCommandTemplate

Enforces strict validation of parameters used in a call to CreateProcess or ShellExecute.

SHExtractIconsW

Creates an array of handles to icons extracted from a specified file.

SHFileOperation

Copies, moves, renames, or deletes a file system object. This function has been replaced in Windows Vista by IFileOperation.

SHFind_InitMenuPopup

Retrieves the IContextMenu instance for the submenu of options displayed for the Search entry in the Classic style Start menu.

SHFindFiles

Displays the Search window user interface (UI).

SHFlushClipboard

Carries out the clipboard shutdown sequence. It also releases the IDataObject pointer placed on the clipboard by the OleSetClipboard function.

SHFlushSFCache

Flushes the special folder cache.

SHFormatDrive

Opens the Shell's Format dialog.

SHFree

Frees the memory allocated by SHAlloc.

SHFreeNameMappings

Frees a file name mapping object that was retrieved by the SHFileOperation function.

SHFreeShared

Frees shared memory, regardless of what process allocated it.

SHGetAttributesFromDataObject

Retrieves specified pieces of information from a system data object.

SHGetDataFromIDList

Retrieves extended property data from a relative identifier list.

SHGetDesktopFolder

Retrieves the IShellFolder interface for the desktop folder, which is the root of the Shell's namespace.

SHGetDiskFreeSpace

Retrieves disk space information for a disk volume.

SHGetDiskFreeSpaceEx

Retrieves disk space information for a disk volume.

SHGetDriveMedia

Returns the type of media that is in the given drive.

SHGetFileInfo

Retrieves information about an object in the file system, such as a file, folder, directory, or drive root.

SHGetFolderLocation

Deprecated. Retrieves the path of a folder as an ITEMIDLIST structure.

SHGetFolderPath

Deprecated. Gets the path of a folder identified by a CSIDL value.

Note  As of Windows Vista, this function is merely a wrapper for SHGetKnownFolderPath. The CSIDL value is translated to its associated KNOWNFOLDERID and then SHGetKnownFolderPath is called. New applications should use the known folder system rather than the older CSIDL system, which is supported only for backward compatibility.
SHGetFolderPathAndSubDir

Gets the path of a folder and appends a user-provided subfolder path.

SHGetIconOverlayIndex

Returns the index of the overlay icon in the system image list.

SHGetIDListFromObject

Retrieves the PIDL of an object.

SHGetImageList

Retrieves an image list.

SHGetInstanceExplorer

Allows components that run in a browser (Iexplore.exe) or a nondefault Windows Explorer (Explorer.exe) process to hold a reference to the process. The components can use the reference to prevent the process from closing prematurely.

SHGetItemFromDataObject

Creates an IShellItem or related object based on an item specified by an IDataObject.

SHGetItemFromObject

Retrieves an IShellItem for an object.

SHGetKnownFolderIDList

Retrieves the path of a known folder as an ITEMIDLIST structure.

SHGetKnownFolderItem

Retrieves an IShellItem object that represents a known folder.

SHGetKnownFolderPath

Retrieves the full path of a known folder identified by the folder's KNOWNFOLDERID.

SHGetLocalizedName

Retrieves the localized name of a file in a Shell folder.

SHGetMalloc

See the Remarks section for alternate recommendations. Retrieves a pointer to the Shell's IMalloc interface.

SHGetNameFromIDList

Retrieves the display name of an item identified by its IDList.

SHGetNameFromPropertyKey

Retrieves the property's canonical name given its PROPERTYKEY.

SHGetNewLinkInfo

Creates a name for a new shortcut based on the shortcut's proposed target. This function does not create the shortcut, just the name.

SHGetPathFromIDList

Converts an item identifier list to a file system path.

SHGetPathFromIDListEx

Converts an item identifier list to a file system path. This function extends SHGetPathFromIDList by allowing you to set the initial size of the string buffer and declare the options below.

SHGetPropertyStoreForWindow

Retrieves an object that represents a specific window's collection of properties, which allows those properties to be queried or set.

SHGetPropertyStoreFromIDList

Retrieves an object that supports IPropertyStore or related interfaces from a PIDL.

SHGetPropertyStoreFromParsingName

Returns a property store for an item, given a path or parsing name.

SHGetRealIDL

Converts a simple PIDL into a full PIDL.

SHGetSetFolderCustomSettings

Sets or retrieves custom folder settings. This function reads from and writes to Desktop.ini.

SHGetSetSettings

Sets or retrieves Shell state settings.

SHGetSettings

Retrieves the current Shell option settings.

SHGetShellStyleHInstance

Deprecated. Attempts to get a handle to the Shellstyle.dll file.

SHGetSpecialFolderLocation

Retrieves a pointer to the ITEMIDLIST structure of a special folder.

SHGetSpecialFolderPath

Retrieves the path of a special folder, identified by its CSIDL.

SHGetStockIconInfo

Retrieves information about system-defined Shell icons.

SHGetTemporaryPropertyForItem

Retrieves the temporary property for the given item. A temporary property is a read/write store that holds properties only for the lifetime of the IShellItem object, rather than being persisted back into the item.

SHGetUnreadMailCount

Retrieves a specified user's unread message count for any or all e-mail accounts.

SHGetViewStatePropertyBag

Retrieves a property bag in which the view state information for a folder can be stored and subsequently retrieved. The user's settings are kept for the next time the user visits the folder.

SHHandleUpdateImage

Handles the SHCNE_UPDATEIMAGE Shell change notification.

SHILCreateFromPath

Creates a PIDL from a path.

SHInvokePrinterCommand

Executes a command on a printer object.

Note  This function has been deprecated as of Windows Vista. It is recommended that, in its place, you invoke verbs on printers through IContextMenu or ShellExecute.
SHIsFileAvailableOffline

Determines whether a file or folder is available for offline use. This function also determines whether the file would be opened from the network, from the local Offline Files cache, or from both locations.

SHLimitInputEdit

Sets limits on valid characters for an edit control.

SHLoadInProc

Creates an instance of the specified object class from within the context of the Shell's process.

Microsoft Windows Vista: This function has been disabled and returns E_NOTIMPL.

SHLoadLibraryFromItem

Creates and loads an IShellLibrary object from a specified library definition file.

SHLoadLibraryFromKnownFolder

Creates and loads an IShellLibrary object for a specified known folder ID.

SHLoadLibraryFromParsingName

Creates and loads an IShellLibrary object for a specified path.

SHLoadNonloadedIconOverlayIdentifiers

Signals the Shell that during the next operation requiring overlay information, it should load icon overlay identifiers that either failed creation or were not present for creation at startup. Identifiers that have already been loaded are not affected.

SHLoadOLE

Deprecated. Provided for backward compatibility.

SHLocalStrDup

Makes a copy of a string in newly allocated memory.

SHLockShared

Maps a block of memory from a specified process into the calling process.

SHMapIDListToImageListIndexAsync

Retrieves an index in the system image list when given an IShellFolder and an ITEMIDLIST that is contained in it. This function also gets the final icon from the callback if necessary.

Note  This function is not implemented in Windows Vista and later operating systems.
SHMapPIDLToSystemImageListIndex

Retrieves the icon index from the system image list that is associated with a folder item.

SHMultiFileProperties

Displays a property sheet for a set of files specified in a Shell ID list array.

SHObjectProperties

Invokes the Properties context menu command on a Shell object.

SHOpenFolderAndSelectItems

Opens a Windows Explorer window with specified items in a particular folder selected.

SHOpenPropSheetW

Creates a property sheet from a list of registry keys that contain the CLSIDs of the individual sheets, then opens the property sheet.

SHOpenWithDialog

Displays the Open With dialog box.

ShowShareFolderUI

Displays the Folder Sharing tab on the properties sheet for the specified folder.

SHParseDisplayName

Translates a Shell namespace object's display name into an item identifier list and returns the attributes of the object. This function is the preferred method to convert a string to a PIDL.

SHPathPrepareForWrite

Checks to see if the path exists. This includes remounting mapped network drives, prompting for ejectable media to be reinserted, creating the paths, prompting for the media to be formatted, and providing the appropriate user interfaces, if necessary. Read/write permissions for the medium are not checked.

SHPropStgCreate

Ensures proper handling of code page retrieval or assignment for the requested property set operation.

SHPropStgReadMultiple

Wraps the IPropertyStorage::ReadMultiple function to ensure that ANSI and Unicode translations are handled properly for deprecated property sets.

SHPropStgWriteMultiple

Wraps the IPropertyStorage::WriteMultiple function to ensure that ANSI and Unicode translations are handled properly for deprecated property sets.

SHQueryRecycleBin

Retrieves the size of the Recycle Bin and the number of items in it, for a specified drive.

SHQueryUserNotificationState

Checks the state of the computer for the current user to determine whether sending a notification is appropriate.

SHRegGetBoolValueFromHKCUHKLM

Not currently supported.

SHRegGetValueFromHKCUHKLM

Not currently supported.

SHRemoveFolderPathFromLibrary

Removes a folder from a library.

SHRemoveLocalizedName

Removes the localized name of a file in a Shell folder.

SHReplaceFromPropSheetExtArray

Requests each property sheet in a property sheet extension array to replace pages. Each page is allowed up to one replacement.

SHResolveFolderPathInLibrary

Attempts to resolve the target location of a library folder that has been moved or renamed.

SHResolveLibrary

Resolves all locations in a library, even those locations that have been moved or renamed.

SHRestricted

Determines whether a specified administrator policy is in effect. In many cases, applications need to modify certain behaviors in order to comply with the policies enacted by system administrators.

SHRunControlPanel

Opens a specific Control Panel item.

Note  This function is not supported in Windows Vista or later operating systems.
SHSaveLibraryInFolderPath

Saves an IShellLibrary object to disk.

SHSetDefaultProperties

Applies the default set of properties on a Shell item.

SHSetFolderPath

Deprecated. Assigns a new path to a system folder identified by its CSIDL.

SHSetInstanceExplorer

Provides an interface to allow hosted components to prevent the Windows Explorer or Windows Internet Explorer process from closing prematurely.

SHSetKnownFolderPath

Redirects a known folder to a new location.

SHSetLocalizedName

Sets the localized name of a file in a Shell folder.

SHSetTemporaryPropertyForItem

Sets a temporary property for the specified item. A temporary property is kept in a read/write store that holds properties only for the lifetime of the IShellItem object, instead of writing them back into the item.

SHSetUnreadMailCount

Stores the current user's unread message count for a specified e-mail account in the registry.

SHShellFolderView_Message

Sends a message to the shell's default implementation of IFolderView.

SHShowManageLibraryUI

Shows the library management dialog box, which enables users to manage the library folders and default save location.

SHSimpleIDListFromPath

Deprecated. Returns a pointer to an ITEMIDLIST structure when passed a path.

SHStartNetConnectionDialog

Displays a general browsing dialog box for network resources connection.

SHTestTokenMembership

Uses CheckTokenMembership to test whether the given token is a member of the local group with the specified RID.

SHUnlockShared

Unlocks memory locked by SHLockShared.

SHUpdateImage

Notifies the Shell that an image in the system image list has changed.

SHValidateUNC

Validates a Universal Naming Convention (UNC) path by calling WNetAddConnection3. The function makes it possible for the user to type a remote network access (RNA)

SignalFileOpen

Deprecated. Sends a notification to the Shell that the specified file has been opened.

SoftwareUpdateMessageBox

Displays a standard message box that can be used to notify a user that an application has been updated.

StgMakeUniqueName

Creates a unique name for a stream or storage object from a template.

StrStrNIW

Finds the first occurrence of a substring within a string. The comparison is case-insensitive.

StrStrNW

Finds the first occurrence of a substring within a string. The comparison is case-sensitive.

TranslateURL

Applies common translations to a given URL string, creating a new URL string.

UnloadUserProfile

Unloads a user's profile that was loaded by the LoadUserProfile function. The caller must have administrative privileges on the computer. For more information, see the Remarks section of the LoadUserProfile function.

UpdateAllDesktopSubscriptions

Deprecated. Enumerates the URLs of all the Desktop components and then tests to see if they are subscribed to. If they are subscribed to, the subscriptions are delivered.

URLAssociationDialog

Invokes the unregistered URL protocol dialog box. This dialog box allows the user to select an application to associate with a previously unknown protocol.

Note  Windows XP SP2 or later: This function is no longer supported.
Win32DeleteFile

Deletes a file.

WinExecError

Not implemented.

WinHelp

Launches Windows Help (Winhelp.exe) and passes additional data that indicates the nature of the help requested by the application.

WOWShellExecute

Performs an operation on a specified file. WOWShellExecute exists only for use with the Microsoft Windows NT Virtual DOS Machine (Ntvdm.exe), which allows disk operating system (DOS) and 16-bit software to run on a Windows system, and should not be used by anyone else. Use ShellExecute instead.

WriteCabinetState

Writes the information contained in a CABINETSTATE structure into the registry.

Tags :


Page view tracker