Method DestroyIconsIfUnused

source/script_gui.cpp:2296–2316

void GuiType::DestroyIconsIfUnused(HICON ahIcon, HICON ahIconSmall)
// Caller has ensured that the GUI window previously using ahIcon has been destroyed prior to calling
// this function.
{
	if (!ahIcon) // At least one caller relies on this check.
		return;
	for (GuiType* gui = g_firstGui; gui; gui = gui->mNextGui)
	{
		// If another window is using this icon, don't destroy the because that has been reported to disrupt
		// the window's display of the icon in some cases (apparently WM_SETICON doesn't make a copy of the
		// icon).  The windows still using the icon will be responsible for destroying it later.
		if (gui->mIconEligibleForDestruction == ahIcon)
			return;
	}
	// Since above didn't return, this icon is not currently in use by a GUI window.  The caller has
	// authorized us to destroy it.
	DestroyIcon(ahIcon);
	// L17: Small icon should always also be unused at this point.
	if (ahIconSmall != ahIcon)
		DestroyIcon(ahIconSmall);
}