RtfwGetSearchPath returns an ordered list of directories to be searched by the wRTOS Subsystem when loading an RTDLL or launching an RTSS application which was not provided with an absolute pathname to the RTDLL or RTSS file. Each directory is separated by a ';' character.
Syntax
bool RtfwGetSearchPath(
[out] TCHAR * pSearchPath,
[in] size_t * pCountCharacters
);Parameters
[out] pSearchPath
A pointer to a buffer that will be filled with an ordered list of absolute pathnames of directories to be searched. If this value is NULL, the value pointed to by pCountCharacters is set to the size of the buffer needed.
[in] pCountCharacters
A pointer to a value that specifies the size of the buffer in characters. If the size of the buffer is not large enough, or if pSearchPath is NULL, this function fails, sets the last error value to ERROR_INSUFFICIENT_BUFFER, and sets this size value to the required number of characters (including the terminating null character).
Return Value
If the function succeeds, it returns TRUE. If the function fails, it returns FALSE, sets the last error value, and leaves the buffer pointed to by pSearchPath invalid. Call GetLastError to obtain an error code.
Remarks
If the Subsystem is running when the RtfwSetSearchPath API is called, the values returned by this function may differ from the values currently in use by the Subsystem.
Requirements
| Minimum supported version | Header | Library |
|---|---|---|
|
wRTOS 1.0 SDK |
RtfwApi.h |
RtfwApi.lib |
See Also:
