Function EnumParentFind

source/window.cpp:662–677

BOOL CALLBACK EnumParentFind(HWND aWnd, LPARAM lParam)
// This function must be kept thread-safe because it may be called (indirectly) by hook thread too.
// To continue enumeration, the function must return TRUE; to stop enumeration, it must return FALSE. 
// It's a little strange, but I think EnumWindows() returns FALSE when the callback stopped
// the enumeration prematurely by returning false to its caller.  Otherwise (the enumeration went
// through every window), it returns TRUE:
{
	WindowSearch &ws = *(WindowSearch *)lParam;  // For performance and convenience.
	if (!ws.mSettings->DetectWindow(aWnd)) // Skip windows the script isn't supposed to detect.
		return TRUE;
	ws.SetCandidate(aWnd);
	// If this window doesn't match, continue searching for more windows (via TRUE).  Likewise, if
	// mFindLastMatch is true, continue searching even if this window is a match.  Otherwise, this
	// first match is the one that's desired so stop here:
	return ws.IsMatch() ? ws.mFindLastMatch : TRUE;
}