Microsoft DirectX 8.1 (Visual Basic)

DirectMusicLoader8.SetSearchDirectory

The SetSearchDirectory method sets the directory to be searched by the DirectMusicLoader8.LoadBand, DirectMusicLoader8.LoadChordMap, DirectMusicLoader8.LoadCollection, DirectMusicLoader8.LoadSegment, and DirectMusicLoader8.LoadStyle methods when a fully qualified path is not supplied.

object.SetSearchDirectory(dir As String)

Parts

object

Resolves to a DirectMusicLoader8 object.

dir

Directory to search.

Error Codes

If the method fails, it raises an error, and Err.Number can be set to one of the following values:

DMUS_E_OUTOFMEMORY
DMUS_E_LOADER_BADPATH

Remarks

Once a search path is set, the loader does not need a full path every time it is given an object to load by file name. This allows objects that refer to other objects to find them by file name without knowing the full path.