Export (0) Print
Expand All
Expand Minimize

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

TopicDescription

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.

 

 

 

Community Additions

ADD
Show:
© 2014 Microsoft