IShellLink::Resolve
[Now
Supported on Windows NT]
Resolves a
shell link. The system searches for the shell link object and updates the shell
link path and its list of identifiers (if necessary).
HRESULT STDMETHODCALLTYPE Resolve(
|
ISHELLLINK FAR *pShlLnk, |
|
|
HWND hwnd, |
|
|
DWORD fFlags |
|
|
); |
|
Parameters
pShlLnk
Pointer to
the IShellLink
interface. In C++, this parameter is implicit.
hwnd
Handle of a
window that the shell uses as the parent window for a dialog box. The shell
displays the dialog box if it needs to prompt the user for more information
while resolving a shell link.
fFlags
Action flags.
This parameter can be a combination of the following values:
|
SLR_ANY_MATCH |
Resolves
the link, displaying a dialog box if the system needs information from the
user. |
|
SLR_NO_UI |
Prevents
the shell from displaying a dialog box if it cannot resolve the shell link.
When this flag is specified, the high-order word of fFlags specifies a
timeout duration, in milliseconds. The function returns if the link cannot be
resolved within the timeout duration. If the high-order word is set to zero,
the timeout duration defaults to 3000 milliseconds (3 seconds). |
|
SLR_UPDATE |
Directs the
shell to update the path to the link and the list of identifiers if the link
object has been changed. If this value is used, it is not necessary to call
the IPersistFile::IsDirty method to determine whether the link object
has changed. |
Return Values
Returns
NOERROR if successful or an OLE-defined error value otherwise.
Remarks
When this
method is called, the system retrieves the path associated with the current
link object and searches for the object in that path. If the system finds the
object, it resolves the link. If the system cannot find the object, it looks in
the same directory for an object with the same file creation time and
attributes, but with a different name. This type of search resolves a link to
an object that has been renamed.
If the system
still cannot find the link object, it searches the subdirectories of the
current directory. It does a recursive search of the directory tree looking for
a match with either the same name or creation time. If it does not find a match
after that, the shell displays a dialog box prompting the user for a location.
An application can suppress the dialog box by specifying the SLR_NO_UI value in
a call to this method.
See Also