get_search_result_link_destination Method
Retrieves the destination of a symbolic link found during a search operation.
Syntax
def get_search_result_link_destination(search_handle: int) -> str: ...
Remarks
This method retrieves the fully-qualified name of a symbolic link found via find_first/find_first_by_query/find_next as part of the search operation identified by SearchHandle. Please refer to those methods' documentation for more information.
The value passed for SearchHandle must be a search operation handle returned by find_first or find_first_by_query.
If the most-recently-found vault item isn't a symbolic link, or if symbolic link destinations were not requested as part of the specified search operation (by passing either 0 or a value including CBFSSTORAGE_FF_NEED_LINK_DEST for the find_first/find_first_by_query method's Flags parameter), this method will always return empty string. Please refer to the documentation for these methods for more information.
Note: This method can only be called when active is True.