Get Adobe Flash player

Shell Fonctions

Topic Description

Intsafe.h Functions

Library Functions

AddMRUStringW

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

Note  This function is available through Windows XP with Service Pack 2 (SP2) and Windows Server 2003. It might be altered or unavailable in subsequent versions of Windows.

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.

Note  This function is available in Windows 2000 and through Windows XP Service Pack 2 (SP2). It is no longer available as of Windows Vista.

CanShareFolderW

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

Note  This function is available through Windows XP with SP2 and Windows Server 2003. It might be altered or unavailable in subsequent versions of Windows.

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.

CreateAppContainerProfile

Creates a per-user, per-app profile for Metro style apps.

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.

Note  This function is available through Windows XP with SP2 and Windows Server 2003. It might be altered or unavailable in subsequent versions of Windows.

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 as of Windows Vista.

CscSearchApiGetInterface

Creates an instance of a CCscSearchApiInterface object.

Warning  This function is deprecated and might be altered or unavailable in subsequent versions.

DAD_AutoScroll

Scrolls the window while an image is being dragged.

Note   DAD_AutoScroll is available in Windows 2000 and Windows XP. It might be altered or unavailable in subsequent versions.

DAD_DragEnterEx

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

Note   DAD_DragEnterEx is available in Windows 2000 and Windows XP. It might be altered or unavailable in subsequent versions. Use ImageList_DragEnter instead.

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.

Note   DAD_DragEnterEx2 is available in Windows 2000 and Windows XP. It might be altered or unavailable in subsequent versions. Use ImageList_DragEnter instead.

DAD_DragLeave

Unlocks the window locked by the DAD_DragEnterEx function.

Note   DAD_DragLeave is available in Windows 2000 and Windows XP. It might be altered or unavailable in subsequent versions. Use ImageList_DragLeave instead.

DAD_DragMove

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

Note   DAD_DragMove is available in Windows 2000 and Windows XP. It might be altered or unavailable in subsequent versions. Use ImageList_DragMove instead.

DAD_SetDragImage

Sets the drag image.

Note   DAD_SetDragImage is available in Windows 2000 and Windows XP. It might be altered or unavailable in subsequent versions. Use ImageList_BeginDrag instead.

DAD_ShowDragImage

Shows or hides the image being dragged.

Note   DAD_ShowDragImage is available in Windows 2000 and Windows XP. It might be altered or unavailable in subsequent versions. Use ImageList_DragShowNolockinstead.

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.

DeleteAppContainerProfile

Deletes the specified per-user, per-app profile.

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.

DeriveAppContainerSidFromAppContainerName

Gets the SID of the specified profile.

DllGetVersion

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

DoEnvironmentSubst

Parses an input string that contains references to one or more environment variables and replaces them with their fully expanded values.

Note  This function is retained only for backward compatibility. UseExpandEnvironmentStrings instead.

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.

Note  This function is available through Windows XP with SP2 and Windows Server 2003. It might be altered or unavailable in subsequent versions of Windows.

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.

Note  This function is available on Windows XP with SP2 through Windows Vista. It might be altered or unavailable in subsequent versions of Windows. Client applications instead should use IAttachmentExecute to present a user environment that provides safe download and exchange of files through email and messaging attachments.

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 directory that contains program data shared by all users.

GetAppContainerFolderPath

Gets the local folder for the specified profile.

GetAppContainerRegistryLocation

Gets the location of the registry storage for the current 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's profile.

GetFileNameFromBrowse

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

Note  This function is available through Windows XP SP2 and Windows Server 2003. It might be altered or unavailable in subsequent versions of Windows.

GetMenuContextHelpId

Retrieves the Help context identifier associated with the specified menu.

GetProfilesDirectory

Retrieves the path to the root directory where 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

Converts a string to a GUID.

Note   GUIDFromString is available through Windows XP with SP2 or Windows Vista. It might be altered or unavailable in subsequent versions. Applications should useCLSIDFromString 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 anotherITEMIDLIST 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 aDWORD 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.

Note  This function is available through Windows XP SP2 and Windows Server 2003. It might be altered or unavailable in subsequent versions of Windows.

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.

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.

Note  This function is available through Windows XP SP2 and Windows Server 2003. It might be altered or unavailable in subsequent versions of Windows. Use GetDriveTypeor WNetGetConnection instead.

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.

Note  This function is available through Windows XP with SP2 and Windows Server 2003. It might be altered or unavailable in subsequent versions of Windows. UseInitCommonControlsEx instead.

LinkWindow_UnregisterClass

Unregisters a window class registered by LinkWindow_RegisterClass.

Note  This function is available through Windows XP with SP2 and Windows Server 2003. It might be altered or unavailable in subsequent versions of Windows.

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.

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.

Note  The ParseField function is currently expected to be available for use in the next version of the Microsoft Windows operating system. It might be altered or unavailable in subsequent versions.

PassportWizardRunDll

Launches the Passport Wizard when used with Rundll32.exe.

Note  This function is available through Windows XP with SP2 and Windows Server 2003. It might be altered or unavailable in subsequent versions of Windows.

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 name 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.

Note  This function is available through Windows XP with SP2 and Windows Server 2003. It might be altered or unavailable in subsequent versions of Windows.

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.

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.

Note  This function is available through Windows XP SP2 and Windows Server 2003. It might be altered or unavailable in subsequent versions of 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.

Note  This function is available through Windows XP SP2 and Windows Server 2003. It might be altered or unavailable in subsequent versions of 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.

SHAddFromPropSheetExtArray

Adds pages to a property sheet extension array created bySHCreatePropSheetExtArray.

Note  This function is available through Windows XP SP2 and Windows Server 2003. It might be altered or unavailable in subsequent versions of Windows.

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

Note  This function is available through Windows XP SP2 and Windows Server 2003. It might be altered or unavailable in subsequent versions of Windows. UseCoTaskMemAlloc instead.

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 name 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 namespaceIShellFolder::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 messages.

SHChangeNotifyRegister

Registers a window to receive 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 class identifier (CLSID) and creates the corresponding CLSID.

Note  This function is available through Windows XP SP2 and Windows Server 2003. It might be altered or unavailable in subsequent versions of Windows. UseCLSIDFromString instead.

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 theIDefaultExtractIconInit 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.

Note  This function is available through Windows XP SP2 and Windows Server 2003. It might be altered or unavailable in subsequent versions of Windows.

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.

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

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

Note  This function is deprecated. Use CreateClassMoniker instead. Note that the CLSID used in the call to CreateClassMoniker must be application-defined. Do not callCreateClassMoniker with a system-defined CLSID.

SHCreateShellFolderView

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

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 orSHCreateItemFromIDList 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 bySHCreatePropSheetExtArray.

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.

Note  This function is available through Windows XP SP2 and Windows Server 2003. It might be altered or unavailable in subsequent versions of Windows.

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 email.

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.

Note   SHExtractIconsW is available through Windows XP SP2. It might be altered or unavailable in subsequent versions.

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 theSearch entry in the Classic style Start menu.

SHFindFiles

Displays the Search window UI.

SHFlushClipboard

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

Note  This function is available through Windows XP SP2 and Windows Server 2003. It is not supported under Windows Vista and later. Use OleFlushClipboard instead.

SHFlushSFCache

Flushes the special folder cache.

SHFormatDrive

Opens the Shell's Format dialog.

SHFree

Frees the memory allocated by SHAlloc.

Note  This function is available through Windows XP SP2 and Windows Server 2003. It might be altered or unavailable in subsequent versions of Windows. UseCoTaskMemFree instead.

SHFreeNameMappings

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

SHFreeShared

Frees shared memory, regardless of which 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 forSHGetKnownFolderPath. The CSIDL value is translated to its associatedKNOWNFOLDERID 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

Retrieves a pointer to the Shell's IMalloc interface.

Note  SHGetMalloc is available through Windows Vista and Windows Server 2003, but may be altered or unavailable in subsequent versions of the operating system or product. See the Remarks section for alternate recommendations.

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 extendsSHGetPathFromIDList by allowing you to set the initial size of the string buffer and declare the options below.

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.

Note  SHGetShellStyleHInstance is available for use in the Windows XP operating system up to and including SP2. It is not available in later versions of Windows, such as Windows Vista.

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 email 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.

Note  This function is available through Windows XP SP2 and Windows Server 2003. It might be altered or unavailable in subsequent versions of Windows.

SHLoadInProc

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

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

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.

Note  This function is available through Windows XP SP2 and Windows Server 2003. It is not supported as of Windows Vista.

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 anITEMIDLIST that is contained in it. This function also gets the final icon from the callback if necessary.

Note  This function is available through Windows XP SP2 and Windows Server 2003. It is not available as of Windows Vista.

SHMapPIDLToSystemImageListIndex

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

SHMultiFileProperties

Displays a merged property sheet for a set of files. Property values common to all the files are shown while those that differ display the string (multiple values).

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.

SHOpenPropSheet

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.

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

Evaluates a registry key value and returns a boolean value that reflects whether the value exists and the expected state matches the actual state. This function will first check HKEY_CURRENT_USER for the requested information in the specified subkey. If the information does not exist under the HKEY_CURRENT_USER subtree it will check the HKEY_LOCAL_MACHINE subtree for the same information.

Note  This function is no longer supported.

SHRegGetValueFromHKCUHKLM

Obtains specified information from the registry. This function will check HKEY_CURRENT_USER for the requested information in the specified subkey. If the information does not exist under the HKEY_CURRENT_USER subtree, the function checks the HKEY_LOCAL_MACHINE subtree for the same information.

Note  This function is no longer supported.

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.

Note  This function is available through Windows XP SP2 and Windows Server 2003. It might be altered or unavailable in subsequent versions of Windows.

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 Control Panel item.

Note  This function is not supported as of Windows Vista

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 email account in the registry.

SHShellFolderView_Message

Sends a message to the shell's default IFolderView implementation (DefView).

SHSimpleIDListFromPath

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

SHStartNetConnectionDialog

Displays a general browsing dialog box for a network resource 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 callingWNetAddConnection3. The function makes it possible for the user to type a remote network access (RNA) UNC application or document name from the Run dialog box on the Start menu.

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

Retrieves the error value generated if the BUGBUG! missing link text: _win32_winexecfunction cannot run a specified application.

Note  This function is no longer 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.

Note  This function is available through Windows XP with SP2 and Windows Server 2003. It might be altered or unavailable in subsequent versions of Windows.

WriteCabinetState

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