1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2<html xml:lang="en-US" lang="en-US" xmlns="http://www.w3.org/1999/xhtml">
3  <head>
4    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
5    <meta http-equiv="Content-Style-Type" content="text/css" />
6    <link rel="stylesheet" href="../../../css/manpage.css" type="text/css" />
7<title>GetFriendPresence</title>
8  </head>
9  <body>
10<h1><CODE><a href="../../../nn/Overview.html">nn</a>::<a href="../../../nn/friends/Overview.html">friends</a>::<a href="../../../nn/friends/CTR/Overview.html">CTR</a>::GetFriendPresence</CODE> Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14<a href="../../../nn/Result/Overview.html">Result</a> GetFriendPresence(
15     <a href="../../../nnfriendsFriendPresence/Overview.html">FriendPresence</a> * pFriendPresenceList,
16     const <a href="../../../nnfriendsFriendKey/Overview.html">FriendKey</a> * pFriendKeyList,
17     size_t size = 1
18);
19
20<a href="../../../nn/Result/Overview.html">Result</a> GetFriendPresence(
21     <a href="../../../nnfriendsFriendPresence/Overview.html">FriendPresence</a> * pFriendPresenceList,
22     const <a href="../../../nn/friends/CTR/PrincipalId.html">PrincipalId</a> * pPrincipalIdList,
23     size_t size = 1
24);
25</pre>
26    </div>
27<h2>List of Overloaded Member Functions</h2>
28    <div class="section">
29      <table class="members">
30        <tr>
31          <td>
32<a href="./GetFriendPresence(0).html"><CODE>GetFriendPresence(FriendPresence *, const FriendKey *, size_t)</CODE> </a>
33          </td>
34<td>Gets a list of friend presence information.</td>
35        </tr>
36        <tr>
37          <td>
38<a href="./GetFriendPresence(1).html"><CODE>GetFriendPresence(FriendPresence *, const PrincipalId *, size_t)</CODE> </a>
39          </td>
40<td>Gets a list of friend presence information.</td>
41        </tr> </table>
42    </div>
43<h2>Description of <CODE>GetFriendPresence(FriendPresence *, const FriendKey *, size_t)</CODE></h2>
44<div class="section"><p>Cannot acquire the invitation flag and game mode of a friend who has a different matchmaking game ID specified.<br /><br />Returns an empty presence in this buffer if there is no friend corresponding to the key passed in the arguments. In this case the function still returns success.<br /><br />The function retrieves an empty presence when a non-existent friend is specified. This is represented by an instance of the <CODE><a href="../../../nn/friends/CTR/FriendPresence.html">nn::friends::CTR::FriendPresence</a></CODE> structure with <CODE>isValid</CODE> set to <CODE>false</CODE>. If the friend is offline, or has made the online status private, then the obtained presence will have <CODE>isValid</CODE> set to <CODE>true</CODE>, but <CODE>isOnline</CODE> will be <CODE>false</CODE>, and the <CODE>gameMode</CODE> structure will be zero-filled.</p><!-- write here --></div>
45<h2>Description of <CODE>GetFriendPresence(FriendPresence *, const PrincipalId *, size_t)</CODE></h2>
46<div class="section"><p>Cannot acquire the invitation flag and game mode of a friend who has a different matchmaking game ID specified.<br /><br />Returns an empty presence in this buffer if there is no friend corresponding to the key passed in the arguments. In this case the function still returns success.<br /><br />The function retrieves an empty presence when a non-existent friend is specified. This is represented by a <CODE><a href="../../../nn/friends/CTR/FriendPresence.html">nn::friends::CTR::FriendPresence</a></CODE> structure that has <CODE>isValid</CODE> set to <CODE>false</CODE>. If the friend is offline, or has made the online status private, then the obtained presence will have <CODE>isValid</CODE> set to <CODE>true</CODE>, but <CODE>isOnline</CODE> will be <CODE>false</CODE>, and the <CODE>gameMode</CODE> structure will be zero-filled.</p><!-- write here --></div>
47  <hr><p>CONFIDENTIAL</p></body>
48</html>