RtfwSetSearchPath

RtfwSetSearchPath sets the ordered list of directories to be searched by the RTX64 Subsystem when loading an RTDLL or launching an RTSS application which was provided without specifying an absolute pathname to the RTDLL or RTSS file.

Syntax

bool RtfwSetSearchPath(
    const TCHAR * pSearchPath
);

Parameters

pSearchPath

A pointer to a string containing a semi-colon-separated list of absolute pathnames of directories to be searched. These directories do not have to exist. The maximum length of each absolute pathname is MAX_PATH – 9 characters.

Return Value

The function returns true if it succeeds. Otherwise, it returns false. Call GetLastError for additional error information.

Possible error codes:

Error Code	Meaning
RT_ERROR_DUPLICATE_SEARCH_PATH	Duplicate search paths were specified.

Remarks

If parameter pSearchPath points to an empty string, the search path is disabled.

Duplicate search paths are not supported.

Any pathname passed to this function must not be a network pathname. This includes:

A pathname with a drive letter that specifies a mapped file share.
A UNC path: a pathname that starts with \\servername.

Requirements

Minimum Required Version	RTX64 3.4
Header	RtfwAPI.h
Library	RtfwAPI.lib