RtfwGetSearchPath

RtfwGetSearchPath returns an ordered list of directories to be searched by the RTX64 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(
    TCHAR * pSearchPath,
    size_t * pCountCharacters
);

Parameters

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.

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

The function returns true if it succeeds. Otherwise, it returns false, sets the last error value, and leaves the buffer pointed to by pSearchPath invalid. Call GetLastError for additional error information.

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 Required Version RTX64 3.4
Header RtfwAPI.h
Library RtfwAPI.lib

See Also:

RtfwSetSearchPath