FSRef to the single most likely target of an alias record.
- macOS 10.0–10.8Deprecated
- Core Services
A pointer to the starting point for a relative search. If you pass
NULLin this parameter,
FSResolveperforms only an absolute search. If you pass a pointer to a valid
FSResolveperforms a relative search for the target, followed by an absolute search only if the relative search fails. If you want to perform an absolute search followed by a relative search, you should use the function
A handle to the alias record to be resolved and, if necessary, updated.
A pointer to an
FSRef. On successful return, this
FSRefdescribes the target of the alias record. This parameter must point to a valid
A pointer to a Boolean value indicating, on return, whether the alias record in the
aliasparameter was updated because it contained some outdated information about the target. If it updates the alias record,
true. Otherwise, it sets it to
FSResolvenever updates a minimal alias, so it never sets
truewhen resolving a minimal alias.
A result code. When it finds the specified volume and parent directory but fails to find the target file or directory in that location,
fnf. Note that the
FSRef in the
alias parameter is not valid in this case.
FSResolve function performs a fast search for the target of the alias. If the resolution is successful,
FSResolve returns (in the
target parameter) the
FSRef for the target file system object, updates the alias record if necessary, and reports (through the
was parameter) whether the record was updated. If the target is on an unmounted AppleShare volume,
FSResolve automatically mounts the volume. If the target is on an unmounted ejectable volume,
FSResolve asks the user to insert the volume. The
FSResolve function exits after it finds one acceptable target.
After it identifies a target,
FSResolve compares some key information about the target with the information in the alias record. If the information differs,
FSResolve updates the record to match the target.
FSResolve function displays the standard dialogs when it needs input from the user, such as a name and password for mounting a remote volume. The user can cancel the resolution through these dialogs.