Skip to main content

XblPresenceGetPresenceForSocialGroupAsync

取得特定使用者群組的線上狀態資訊。

語法

參數

xblContextHandle   _In_
類型:XblContextHandle
本機使用者的 XBOX Live 內容。 socialGroupName   _In_z_
類型:char*
要取得其線上狀態的使用者群組名稱。可以是 “Favorites” 以擷取最愛的相關資訊、“People” 以擷取共同好友及使用者所追蹤之人員的相關資訊,或 “Friends” 以擷取共同好友的相關資訊。 socialGroupOwnerXuid   _In_opt_
類型:uint64_t*
應以其群組為目標的使用者。如果輸入為 null,將使用目前的使用者。 filters   _In_opt_
類型:XblPresenceQueryFilters*
用來篩選結果的選用篩選條件結構。 async   _In_
類型:XAsyncBlock*
此作業的 AsyncBlock。

傳回值

類型:HRESULT 此 API 作業的 HRESULT 傳回碼。

備註

若要擷取呼叫 XblPresenceGetPresenceForSocialGroupAsync 的結果,請呼叫 XblPresenceGetPresenceForSocialGroupResult。若要擷取保存呼叫 XblPresenceGetPresenceForSocialGroupAsync 之結果所需的緩衝區大小,請呼叫 XblPresenceGetPresenceForSocialGroupResultCount。

需求

標頭: presence_c.h 程式庫: Microsoft.Xbox.Services.14x.GDK.C.lib

另請參閱

presence_c
Last modified on October 6, 2026