Wiley-World.of.Warcraft.Programming.A.Guide.and.Reference.for.Creating.WoW.Addons

762 Part IV ■ ReferenceOnly valid when the questgiver UI is showing the accept/decline stage of aquest dialog (between the QUEST_COMPLETE and QUEST_FINISHED events);otherwise may return the empty string or a value from the most recentlydisplayed quest.Returns:questObjective—The objective text for the currently displayed quest(string)GetOptOutOfLootReturns whether the player has opted out of loot rolls.isOptOut = GetOptOutOfLoot()When opting out, no prompt will be shown for loot which ordinarily wouldprompt the player to roll (need/greed) or pass; the loot rolling process willcontinue for other group members as if the player had chosen to pass on everyroll.Returns:isOptOut—1 if the player has opted out of loot rolls; otherwise nil (1nil)GetOwnerAuctionItemsRequests data from the server for the list of auctions created by the player.The AUCTION_OWNED_LIST_UPDATE event fires if new data is available; listinginformation can then be retrieved using GetAuctionItemInfo() or otherAuction APIs.GetPVPDesiredReturns whether the player has manually enabled PvP status.isPVPDesired = GetPVPDesired()Only indicates whether the player has manually and directly enabled his PvPflag (e.g. by typing ‘‘/pvp’’ or using the default UI’s menu when right-clickingthe player portrait); returns 0 if the player only became PvP flagged byattacking an enemy player, entering an enemy zone, etc.Returns:isPVPDesired—1 if the PVP flag was toggled on by the player manually; otherwise0 (number)GetPVPLifetimeStatsReturns the player’s lifetime total of honorable kills and highest rank achieved.hk, highestRank = GetPVPLifetimeStats()Highest rank achieved applies only to the older PvP rewards system that wasabandoned with the WoW 2.0 patch, but is still accurate for players whoparticipated in it.Returns:hk—Number of honorable kills the player has scored (number)highestRank—Highest rank the player ever achieved in the pre-2.0 PvPrewards system (number)