Deprecated Shell APIs

[ FOLDERSETDATA may be altered or unavailable in subsequent versions of the operating system or product.]

[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. ]

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

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

[CharLowerWrapW is available for use in Windows XP. It may not be available in subsequent versions. You should use CharLowerW in its place.]

[CharUpperBuffWrapW is available for use in Windows XP. It may not be available in subsequent versions. You should use CharUpperBuffW in its place.]

[CompareStringWrapW is available for use in Windows XP. It will not be available in subsequent versions. You should use CompareStringW in its place.]

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

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

[This function is not available as of Windows Vista.]

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

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

[ 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 is available in Windows 2000 and Windows XP. It might be altered or unavailable in subsequent versions. Use ImageList_DragEnter instead.]

[ 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 is available in Windows 2000 and Windows XP. It might be altered or unavailable in subsequent versions. Use ImageList_DragMove instead. ]

[ 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 is available in Windows 2000 and Windows XP. It might be altered or unavailable in subsequent versions. Use ImageList_DragShowNolock instead. ]

[This function is retained only for backward compatibility. Use ExpandEnvironmentStrings instead.]

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

[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.]

[FindResourceWrapW is available for use in Windows XP. It may not be available in subsequent versions. You should use FindResourceW instead.]

[GetDateFormatWrapW is available for use in Windows XP. It will not be available in subsequent versions. You should use GetDateFormatW in its place.]

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

[GetTimeFormatWrapW is available for use in Windows XP. It may not be available in subsequent versions. You should use GetTimeFormatW in its place.]

[ GUIDFromString is available through Windows XP with SP2 or Windows Vista. It might be altered or unavailable in subsequent versions. Applications should use CLSIDFromString or IIDFromString in place of this function.]

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

[IsCharAlphaNumericWrapW is available for use in Windows XP. It will not be available in subsequent versions. You should use IsCharAlphaNumericW in its place.]

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

[This interface is supported through Windows XP SP2 and Windows Server 2003. It might be unsupported in subsequent versions of Windows.]

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

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

[This function is not available for use as of Windows 7.]

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

[This function is not available for use as of Windows 7.]

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

[This function is available for use in Windows XP. It may not be available in subsequent versions. Use OutputDebugStringW in its place.]

[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.]

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

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

[This function is not supported as of Windows Vista.]

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

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

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

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

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

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

[This structure is not supported.]

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

[SHCreateProcessAsUserW is not implemented under Windows XP or later systems.]

[SHCreateProcessAsUserW is no longer implemented in Windows XP or later versions.]

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

[ SHDestroyPropSheetExtArray is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

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

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

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

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

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

[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.]

[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.]

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

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

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

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

[This function is no longer supported.]

[This function is no longer supported.]

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

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

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

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

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

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

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

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

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

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

[This object is supported through Windows XP SP2 and Windows Server 2003. It might be unsupported in subsequent versions of Windows.]

[This object is supported through Windows XP SP2 and Windows Server 2003. It might be unsupported in subsequent versions of Windows.]

[This object is supported through Windows XP SP2 and Windows Server 2003. It might be unsupported in subsequent versions of Windows.]

[This object is supported through Windows XP SP2 and Windows Server 2003. It might be unsupported in subsequent versions of Windows.]

[This object is supported through Windows XP SP2 and Windows Server 2003. It might be unsupported in subsequent versions of Windows.]

[This object is supported through Windows XP SP2 and Windows Server 2003. It might be unsupported in subsequent versions of Windows.]

[The only method, DoContextMenuPopup, is no longer available for use as of Windows Server 2003.]

[This interface has been deprecated. It is supported through Windows XP SP2 and Windows Server 2003. It is not supported as of Windows Vista.]

[ IDeskBandInfo may be altered or unavailable in subsequent versions of the operating system or product.]

[This interface is supported through Windows XPSP2 and Windows Server 2003. It might be unsupported in subsequent versions of Windows.]

[This interface is supported through Windows XP SP2 and Windows Server 2003. It might be unsupported in subsequent versions of Windows.]

[This interface is supported through Windows XP SP2 and Windows Server 2003. It is not supported as of Windows Vista.]

[The IEnumSyncItems interface is available for use through Windows XP. It is not available in subsequent versions of Windows.]

[The IEnumSyncSchedules interface is available for use through Windows XP. It is unavailable in subsequent versions of Windows.]

[The IIdentityChangeNotify interface is available for use in Windows 2000. In Windows XP, this functionality has been superseded by User Accounts with Fast User Switching and Remote Desktop, and might be altered or unavailable in subsequent versions.]

[This interface is supported through Windows XP SP2 and Windows Server 2003. It might be unsupported in subsequent versions of Windows.]

[This interface is not supported as of Windows Vista. It has been removed from the public headers.]

[This interface is supported through Windows XP SP2 and Windows Server 2003. It is not supported as of Windows Vista.]

[This interface is supported through Windows XP SP2 and Windows Server 2003. It might be unsupported in subsequent versions of Windows.]

[ IShellFolderView is no longer available for use as of Windows 7. Instead, use IFolderView2 and IFolderView.]

[This interface will eventually be unsupported. It is recommended that Windows GDI+ APIs be used in place of IShellImageData methods.]

[IShellTaskScheduler2 is available in Windows XP. It might be altered or unavailable in subsequent versions.]

[The ISyncSchedule interface is available for use through Windows XP. It is not available in subsequent versions of Windows.]

[The ISyncScheduleMgr interface is available for use through Windows XP. It is not available in subsequent versions of Windows.]

[ ITravelEntry may not be supported in versions of Windows later than Windows XP.]

[This notification is supported through Windows XP SP2 and Windows Server 2003. It might be unsupported in subsequent versions of Windows.]

[This notification is supported through Windows XP SP2 and Windows Server 2003. It might be unsupported in subsequent versions of Windows.]

The following APIs are either deprecated or superseded by newer APIs.

In this section

Topic Description
AUTO_SCROLL_DATA
AUTO_SCROLL_DATA may be altered or unavailable.
CABINETSTATE
CABINETSTATE may be altered or unavailable.
DESKBANDINFO
Receives information about a band object. This structure is used with the deprecated IDeskBand::GetBandInfo method.
SECURELOCK
Deprecated. This enumeration is used by the BASEBROWSERDATA structure to indicate the base browser's lock icon status.
FOLDERSETDATA
Deprecated. Data used in IBrowserService2::GetFolderSetData.
TOOLBARITEM
Deprecated. Data used in IBrowserService2::_GetToolbarItem, IBrowserService2::v_MayGetNextToolbarFocus, and IBrowserService2::_SetFocus to define a toolbar item.
AddMRUStringW
Adds a string to the top of the most recently used (MRU) list.
CallCPLEntry16
Performs no function. Provided for backward compatibility.
CanShareFolderW
Used to determine whether to show the Share this folder option in web view.
CharLowerWrapW
Converts a Unicode character string or a single character to lowercase. If the operand is a character string, the function converts the characters in place.
Note: CharLowerWrapW is a wrapper for the CharLowerW function. See the CharLower page for further usage notes.
CharUpperBuffWrapW
Converts lowercase characters in a buffer to uppercase characters. The function converts the characters in place.
Note: CharUpperBuffWrapW is a wrapper for the CharUpperBuffW function. See the CharUpperBuff page for further usage notes.
CIDLData_CreateFromIDArray
CIDLData_CreateFromIDArray may be altered or unavailable.
CompareStringWrapW
Compares two Unicode character strings, using a specified locale.
Note: CompareStringWrapW is a wrapper for the CompareStringW function. See the CompareString page for further usage notes.
ConnectToConnectionPoint
Establishes or terminates a connection between a client's sink and a connection point container.
CreateHardwareEventMoniker
Creates a moniker representing a hardware component and its associated event handler. AutoPlay uses this function to allow applications to use AutoPlay events.
CreateUserProfileEx
Creates a user profile for a specified user.
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.
DoEnvironmentSubst
Parses an input string that contains references to one or more environment variables and replaces them with their fully expanded values.
DriveType
DriveType may be altered or unavailable.
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.
ExtractAssociatedIconEx
ExtractAssociatedIconEx may be altered or unavailable.
FindResourceWrapW
Determines the location of a resource with the specified type and name, in the specified module.
Note: FindResourceWrapW is a wrapper for the FindResourceW function. See FindResource for further usage notes.
GetDateFormatWrapW
Formats a date as a date string for a specified locale. The function formats either a specified date or the local system date.
Note: GetDateFormatWrapW is a wrapper for the GetDateFormatW function. See the GetDateFormat page for further usage notes.
GetFileNameFromBrowse
Creates an Open dialog box so that the user can specify the drive, directory, and name of a file to open.
GetMenuPosFromID
GetMenuPosFromID may be altered or unavailable.
GetTimeFormatWrapW
Formats time as a time string for a specified locale. The function formats either a specified time or the local system time.
Note: GetTimeFormatWrapW is a wrapper for the GetTimeFormatW function. See the GetTimeFormat page for further usage notes.
GUIDFromString
Converts a string to a GUID.
ILLoadFromStream
Deprecated. Loads an ITEMIDLIST structure from a stream.
ILLoadFromStreamEx(IStream*, PIDLIST_ABSOLUTE*)
This function may be altered or unavailable.
ILLoadFromStreamEx(IStream*, PIDLIST_RELATIVE*)
This function may be altered or unavailable.
ILLoadFromStreamEx(IStream*, PITEMID_CHILD*)
This function may be altered or unavailable.
IsCharAlphaNumericWrapW
Determines whether a character is either an alphabetical or a numeric character. This determination is based on the semantics of the language selected by the user during setup or through Control Panel.
Note: IsCharAlphaNumericWrapW is a wrapper for the IsCharAlphaNumericW function. See the IsCharAlphaNumeric page for further usage notes.
IsNetDrive
Tests whether a drive is a network drive.
IsUserAnAdmin
IsUserAnAdmin may be altered or unavailable.
LPFNDFMCALLBACK
LPFNDFMCALLBACK may be altered or unavailable.
LPFNVIEWCALLBACK
Defines the prototype for the callback function used by the system folder view object. This function essentially duplicates the functionality of IShellFolderViewCB.
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.
MLFreeLibrary
Unmaps a resource DLL loaded by the MLLoadLibrary function.
MLHtmlHelp
Displays a help window that corresponds to the current UI language setting.
MLLoadLibrary
Maps an appropriate resource DLL into the address space of the calling function, based on the user's default UI language.
MLWinHelp
Starts Windows Help (Winhelp.exe) and passes additional data that indicates the nature of the help requested by the application.
OpenRegStream
OpenRegStream may be altered or unavailable. Instead, use SHOpenRegStream2 or SHOpenRegStream.
OutputDebugStringWrapW
Sends a Unicode string to the debugger for display.
Note: OutputDebugStringWrapW is a wrapper for the OutputDebugStringW function. See the OutputDebugString page for further usage notes.
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
PathCleanupSpec may be altered or unavailable.
PathGetShortPath
PathGetShortPath may be altered or unavailable.
PathIsExe
PathIsExe may be altered or unavailable.
PathIsSlow
PathIsSlow may be altered or unavailable.
PathProcessCommand
Deprecated. Processes a string that contains a command line and generates a suitably quoted string, with arguments attached if required.
PathResolve
PathResolve may be altered or unavailable.
PerUserInit
Creates My Documents and other special folders, initializes them as needed, and creates the Send To shortcut menu item for My Documents.
PFNASYNCICONTASKCALLBACK
Defines the prototype for the callback function used by SHMapIDListToImageListIndexAsync.
PickIconDlg
PickIconDlg may be altered or unavailable.
ReadCabinetState
ReadCabinetState may be altered or unavailable.
RealDriveType
RealDriveType may be altered or unavailable.
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.
SHAddFromPropSheetExtArray
Adds pages to a property sheet extension array created by SHCreatePropSheetExtArray.
SHAlloc
Allocates memory from the Shell's heap.
SHAllocShared
SHAllocShared may be altered or unavailable.
SHAnsiToAnsi
Copies an ANSI string.
SHAnsiToUnicode
Converts a string from the ANSI code page to the Unicode code page.
SHChangeDWORDAsIDList
SHChangeDWORDAsIDList may be altered or unavailable.
SHChangeProductKeyAsIDList
SHChangeUpdateImageIDList
SHChangeUpdateImageIDList may be altered or unavailable.
SHCloneSpecialIDList
SHCloneSpecialIDList may be altered or unavailable. Instead, use SHGetSpecialFolderLocation.
SHCLSIDFromString
Takes the string form of a class identifier (CLSID) and creates the corresponding CLSID.
SHCoCreateInstance
SHCoCreateInstance may be altered or unavailable. Instead, use CoCreateInstance.
SHCreateDirectory
Creates a new file system folder.
SHCreateDirectoryEx
Creates a new file system folder, with optional security attributes.
SHCreateFileExtractIcon
SHCreateFileExtractIcon may be altered or unavailable.
SHCreateProcessAsUserW
Creates a new user-mode process and its primary thread to run a specified executable file.
SHCREATEPROCESSINFOW
Contains the information needed by SHCreateProcessAsUserW to create a process.
SHCreatePropSheetExtArray
SHCreatePropSheetExtArray may be altered or unavailable.
SHCreateQueryCancelAutoPlayMoniker
Deprecated. Creates a QueryCancelAutoPlay class moniker, which can then be used to register the IQueryCancelAutoPlay handler in the running object table (ROT).
SHCreateStdEnumFmtEtc
SHCreateStdEnumFmtEtc may be altered or unavailable.
SHCreateStreamOnFile
SHCreateStreamOnFile may be altered or unavailable. Instead, use SHCreateStreamOnFileEx.
SHDestroyPropSheetExtArray
Frees property sheet handlers that are pointed to an array created by SHCreatePropSheetExtArray.
Shell_GetCachedImageIndex
Shell_GetCachedImageIndex may be altered or unavailable.
Shell_GetImageLists
Retrieves system image lists for large and small icons.
Shell_MergeMenus
Shell_MergeMenus may be altered or unavailable.
ShellMessageBox
ShellMessageBox may be altered or unavailable.
SHExtractIconsW
Creates an array of handles to icons extracted from a specified file.
SHFind_InitMenuPopup
SHFind_InitMenuPopup may be altered or unavailable.
SHFindFiles
SHFindFiles may be altered or unavailable.
SHFlushClipboard
Carries out the clipboard shutdown sequence. It also releases the IDataObject pointer placed on the clipboard by the OleSetClipboard function.
SHFlushSFCache
SHFlushSFCache may be altered or unavailable.
SHFormatDateTime
SHFormatDateTime may be altered or unavailable.
SHFormatDrive
SHFormatDrive may be altered or unavailable.
SHFree
Frees the memory allocated by SHAlloc.
SHFreeShared
SHFreeShared may be altered or unavailable.
SHGetAttributesFromDataObject
SHGetAttributesFromDataObject may be altered or unavailable.
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.
SHGetInverseCMAP
Retrieves the inverse color table mapping for the halftone palette.
SHGetMalloc
Retrieves a pointer to the Shell's IMalloc interface.
SHGetRealIDL
SHGetRealIDL may be altered or unavailable.
SHGetSetFolderCustomSettings
SHGetSetFolderCustomSettings may be altered or unavailable.
SHGetSetSettings
SHGetSetSettings may be altered or unavailable.
SHGetShellStyleHInstance
Deprecated. Attempts to get a handle to the Shellstyle.dll file.
SHGetSpecialFolderLocation
SHGetSpecialFolderLocation is not supported and may be altered or unavailable in the future. Instead, use SHGetFolderLocation.
SHGetSpecialFolderPath
SHGetSpecialFolderPath is not supported. Instead, use ShGetFolderPath.
SHGetViewStatePropertyBag
SHGetViewStatePropertyBag may be altered or unavailable.
SHHandleUpdateImage
SHHandleUpdateImage may be altered or unavailable.
SHILCreateFromPath
SHILCreateFromPath may be altered or unavailable.
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.
SHIsChildOrSelf
Compares whether a window is equal to, a child of, or a descendant of, a second window.
SHLimitInputEdit
Sets limits on valid characters for an edit control.
SHLoadOLE
Deprecated. Provided for backward compatibility.
SHLockShared
SHLockShared may be altered or unavailable.
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.
SHMapPIDLToSystemImageListIndex
SHMapPIDLToSystemImageListIndex may be altered or unavailable.
SHMessageBoxCheck
SHMessageBoxCheck may be altered or unavailable.
SHObjectProperties
SHObjectProperties may be altered or unavailable.
SHOpenPropSheet
SHOpenPropSheet may be altered or unavailable.
SHOpenRegStream
Deprecated. Opens a registry value and supplies a stream that can be used to read from or write to the value.
Note: This function has been replaced by SHOpenRegStream2. It is recommended that you use SHOpenRegStream2 at all times.
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.
SHRegGetValue
Retrieves a registry value.
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.
SHReplaceFromPropSheetExtArray
Requests each property sheet in a property sheet extension array to replace pages. Each page is allowed up to one replacement.
SHRestricted
SHRestricted may be altered or unavailable.
SHSetFolderPath
Deprecated. Assigns a new path to a system folder identified by its CSIDL.
SHSendMessageBroadcast
Sends a message to all top-level windows in the system.
SHShellFolderView_Message
SHShellFolderView_Message may be altered or unavailable.
SHSimpleIDListFromPath
Deprecated. Returns a pointer to an ITEMIDLIST structure when passed a path.
SHStartNetConnectionDialog
SHStartNetConnectionDialog may be altered or unavailable.
SHStripMneumonic
Removes the mnemonic marker from a string.
SHUnicodeToAnsi
Converts a string from the Unicode code page to the ANSI code page.
SHUnicodeToUnicode
Copies a Unicode string.
SHUnlockShared
SHUnlockShared may be altered or unavailable.
SHValidateUNC
SHValidateUNC may be altered or unavailable.
SignalFileOpen
SignalFileOpen may be altered or unavailable.
StopWatchFlush
StopWatchFlush may be altered or unavailable.
StopWatchMode
StopWatchMode may be altered or unavailable.
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.
UrlFixupW
UrlFixupW may be altered or unavailable.
WhichPlatform
WhichPlatform may be altered or unavailable.
Win32DeleteFile
Win32DeleteFile may be altered or unavailable.
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
WriteCabinetState may be altered or unavailable.
SHLWAPI Wrapper Functions
The tables in this document list wrapper functions from Shlwapi.dll that provide limited Unicode functionality to Windows 95, Windows 98, and Windows Millennium Edition (Windows Me).
FileOpen
Supports the File Open common dialog box.
FileTypes
Creates the File Types page of the Folder Options property sheet that the user displays by clicking Folder Options on the Windows Explorer Tools menu.
FolderItemsFDF
Represents a Shell folder and all its children.
ImageRecompress
Used to recompress an image.
MenuBand
Supports Shell menu bands.
MenuBandSite
Gets or sets menu band site information.
NewMenu
Creates a New context menu for a Shell item.
ShellFldSetExt
Creates a Folder Options dialog box.
ShellFolderBand
Manages folder bands. The Quick Launch bar is an example of a folder band.
Shell Image Store
Creates an instance of an IShellImageStore object.
IBrowserService
Deprecated. The methods exposed by this interface are analogous to virtual protected methods in normal C++ inheritance. The objects' inheritance hierarchy spans multiple DLLs. The hierarchy is made up of a base class and several derived classes that correspond to controls, including CLSID_WebBrowser and the user's desktop. Objects not in the hierarchy should not implement this interface or use most of its methods.
IBrowserService2
Deprecated. IBrowserService2 extends IBrowserService. The methods exposed by this interface are analogous to virtual protected methods in normal C++ inheritance. The objects' inheritance hierarchy spans multiple DLLs. The hierarchy is made up of a base class and several derived classes that correspond to controls including CLSID_WebBrowser and the user's desktop. Objects not in the hierarchy should not implement this interface or use most of its methods.
IBrowserService3
Deprecated. The methods exposed by this interface are analogous to virtual protected methods in normal C++ inheritance. The inheritance hierarchy of the objects spans multiple DLLs. The hierarchy is made up of a base class and several derived classes that correspond to controls, including CLSID_WebBrowser and the user's desktop. Objects not in the hierarchy should not implement this interface, nor use most of its methods.
IBrowserService4
Deprecated.
ICDBurnExt
ICDBurnExt may be altered or unavailable.
IColumnProvider
Exposes methods that enable the addition of custom columns in the Windows Explorer Details view.
Note: Support for IColumnProvider has been removed as of Windows Vista. The Windows property system is used in its place. See Windows Property System for conceptual materials that explain the use of the new system.
IContextMenuSite
Implemented by the default folder view created using SHCreateShellFolderView. An implementation of IContextMenuSite supports IContextMenu::QueryContextMenu, IContextMenu::InvokeCommand, and TrackPopupMenu and any message forwarding necessary for that function. IContextMenuSite typically updates the status bar as well.
IDefViewFrame
Used only for its IUnknown functionality. It has no methods of its own.
IDefViewID
IDefViewID may be altered or unavailable.
IDefViewSafety
Deprecated. Exposes one method that determines a page's web content zone setting before the page is accessed.
IDeskBand
Used to obtain information about a band object.
Important:
You should use thumbnail toolbars in new development in place of desk bands, which are not supported as of Windows 7.
IDeskBand2
Exposes methods to enable and query translucency effects in a deskband object.
Important:
You should use thumbnail toolbars in new development in place of desk bands, which are not supported as of Windows 7.
IDeskBandInfo
Exposes a method for getting the default Desk Band bandwidth.
IDeskBar
Exposes methods that enable desk bar manipulation.
IDocViewSite
Used as a site object by the IShellView interface.
IDVGetEnum
Exposes methods that allow the system folder view object to provide another object with an enumeration of items, without the second object running a redundant enumeration itself.
IEnumSyncItems
Exposes methods that provide enumeration of all items in a synchronization schedule.
IEnumSyncSchedules
Provides enumeration of all synchronization schedules.
IEnumUserIdentity
IEnumUserIdentity is not supported and may be altered or unavailable in the future. Instead, use User Accounts with Fast User Switching and Remote Desktop.
IExpDispSupport
Deprecated. Exposes methods that allow the retrieval of properties, translation of keyboard accelerators, and determination of a connection point for certain events.
IExpDispSupportXP
Deprecated. Exposes methods that allow the retrieval of properties, translation of keyboard accelerators, and determination of a connection point for certain events.
IFolderBandPriv
IFolderBandPriv is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.
IIdentityChangeNotify
Deprecated. Provides notification of modifications to user identities on the system, as well as user requests to switch the current user identity.
IInsertItem
IInsertItem may be altered or unavailable.
IMenuBand
Exposes methods that allow a Component Object Model (COM) object to receive and translate appropriate messages.
IPassportClientServices
The IPassportClientServices interface exposes a method to determine whether a Windows Live ID exists.
IPassportWizard
Exposes a method that invokes the Windows XP Passport Wizard.
IRegTreeItem
Exposes methods that retrieve and set the state of items in a tree-view control that have the Tree-View Control Window Styles flag set.
IShellExecuteHook
Note: Shell execute hooks are deprecated as of Windows Vista.
Exposes a method that extends the behavior of the ShellExecute or ShellExecuteEx functions. It is typically implemented by subsystems that expose the names of objects that the user can specify in the Run dialog box after clicking the Windows Start button.
IShellFolderBand
IShellFolderBand may be altered or unavailable.
IShellFolderView
Exposes methods that manipulate Shell folder views.
IShellIconOverlayManager
IShellIconOverlayManager may be altered or unavailable.
IShellImageData
Exposes methods and properties that display, manipulate, and describe image data.
IShellImageStore
Deprecated. Exposes methods that manipulate the image cache.
IShellService
Deprecated. IShellService Exposes one method that declares ownership when a service component implementing a certain interface is shared among multiple clients, such as Windows Internet Explorer and Windows Explorer.
IShellTaskScheduler
IShellTaskScheduler may be altered or unavailable.
IShellTaskScheduler2
Extends the functionality of IShellTaskScheduler by inheriting all of its methods, providing the ability to place a task in the queue with reference to other tasks of its priority, and adding a method to reset a task's priority.
ISyncSchedule
Exposes methods associated with an individual synchronization schedule.
ISyncScheduleMgr
Exposes methods to set up and control a synchronization scheduler for synchronization management.
IThumbnailCapture
Exposes a method that obtains a thumbnail representation of an HTML wallpaper.
Note: This interface is deprecated as of Windows 7. The feature it supported is no longer present in Windows.
ITravelEntry
Deprecated. Exposes methods to identify, invoke, and update an individual item in the browser's travel history.
ITravelLog
Deprecated. Exposes methods that maintain and manipulate a record of travel in the browser.
IUserIdentity
IUserIdentity is not supported and may be altered or unavailable in the future. Instead, use User Accounts with Fast User Switching and Remote Desktop.
IUserIdentity2
IUserIdentity2 is not supported and may be altered or unavailable in the future. Instead, use User Accounts with Fast User Switching and Remote Desktop.
IUserIdentityManager
IUserIdentityManager is not supported and may be altered or unavailable in the future. Instead, use User Accounts with Fast User Switching and Remote Desktop.
SFVM_DIDDRAGDROP
SFVM_DIDDRAGDROP may be altered or unavailable.
SFVM_GETDETAILSOF
SFVM_GETDETAILSOF may be altered or unavailable.
SFVM_GETPANE
SFVM_GETPANE may be altered or unavailable.
SFVM_GETZONE
Allows the callback object to provide Internet zone information. Used by IShellFolderViewCB::MessageSFVCB.
SFVM_QUERYFSNOTIFY
SFVM_QUERYFSNOTIFY may be altered or unavailable.
SFVM_SETISFV
Notifies the callback object of the container site. This is used only when IObjectWithSite::SetSite is not supported and SHCreateShellFolderViewEx is used. Used by IShellFolderViewCB::MessageSFVCB.
SFVM_THISIDLIST
SFVM_THISIDLIST may be altered or unavailable.