ResolveLink Method

Retrieves the destination of a symbolic link.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
char* ResolveLink(const char* lpszLinkName, int bNormalize);

Unicode (Windows)
LPWSTR ResolveLink(LPCWSTR lpszLinkName, BOOL bNormalize);

- (NSString*)resolveLink:(NSString*)linkName :(BOOL)normalize;

#define MID_CBDRIVE_RESOLVELINK 75

CBFSSTORAGE_EXTERNAL int CBFSSTORAGE_CALL CBFSStorage_CBDrive_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

Remarks

This method retrieves the destination pointed to by the symbolic link specified by LinkName.

The value passed for LinkName must be a vault-local absolute path.

As the CreateLink method's documentation describes, symbolic links can be created with either relative or absolute vault-local paths. The Normalize parameter specifies whether the class should normalize the specified link's destination before returning it. Passing true will ensure a vault-local absolute path is always returned; passing false will cause the original destination path to be returned.

Note: This method can only be called when Active is true.

Error Handling (C++)

This method returns a String value; after it returns, call the GetLastErrorCode() method to obtain its result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message.