EOS_Sessions_CopySessionHandleByInviteId

EOS API reference page for EOS_Sessions_CopySessionHandleByInviteId

Choose your implementation method:

C

C#

This function is part of the Sessions Interface.

Remarks

EOS_Sessions_CopySessionHandleByInviteId is used to immediately retrieve a handle to the session information from after notification of an invite If the call returns an EOS_Success result, the out parameter, OutSessionHandle, must be passed to EOS_SessionDetails_Release to release the memory associated with it.

Return Value

  • EOS_Success if the information is available and passed out in OutSessionHandle

  • EOS_InvalidParameters if you pass an invalid invite ID or a null pointer for the out parameter

  • EOS_IncompatibleVersion if the API version passed in is incorrect

  • EOS_NotFound if the invite ID cannot be found

See Also

EOS_Sessions_CopySessionHandleByInviteIdOptions, EOS_SessionDetails_Release

Parameters

EOS_Sessions_CopySessionHandleByInviteId

Parameter Type And Name

Usage Information

EOS_HSessions Handle

const EOS_Sessions_CopySessionHandleByInviteIdOptions* Options

Structure containing the input parameters

EOS_HSessionDetails* OutSessionHandle

out parameter used to receive the session handle

If successful, this function provides data to the caller through an output parameter. Once you are finished with the data, you must release it by making the appropriate call into the EOS SDK.

Related API Members

This function is part of the Sessions Interface.

Remarks

{CopySessionHandleByInviteId} is used to immediately retrieve a handle to the session information from after notification of an invite If the call returns an {Result.Success} result, the out parameter, OutSessionHandle, must be passed to {SessionDetails.Release} to release the memory associated with it. {Result.InvalidParameters} if you pass an invalid invite ID or a null pointer for the out parameter {Result.IncompatibleVersion} if the API version passed in is incorrect {Result.NotFound} if the invite ID cannot be found

Return Value

{Result.Success} if the information is available and passed out in OutSessionHandle

See Also

{CopySessionHandleByInviteIdOptions}, {SessionDetails.Release}

Parameters

Sessions.SessionsInterface.CopySessionHandleByInviteId

Parameter Type And Name

Usage Information

CopySessionHandleByInviteIdOptions options

Structure containing the input parameters

SessionDetails outSessionHandle

out parameter used to receive the session handle

If successful, this function provides data to the caller through an output parameter. The EOS SDK will automatically handle releasing the data when your code no longer holds any reference to it; you do not need to call a "Release" function.

Related API Members