nn::nex::Network::SetP2PDataPacketSessionSignatureKey Member Function

Syntax

void SetP2PDataPacketSessionSignatureKey(
     const qVector< qByte > & sessionKey
);

Parameters

Name Description
in sessionKey Session signature key.

Return Values

None.

Description

Sets the key to use when computing a signature for each peer-to-peer communication session.

Sets a P2P communication signature key that can be obtained with the MatchmakeSession::GetSessionKey, MatchmakeExtensionClient::CreateMatchmakeSession, or MatchmakeExtensionClient::JoinMatchmakeSession functions. For more information about how to get the key with the MatchmakeSession::GetSessionKey function, see the security chapter in the manual. A key can be set by calling the Network::GetInstance function and then the SetP2PDataPacketSessionSignatureKey function.

When set, this key is used instead of the key set with the Network::SetP2PDataPacketDefaultSignatureKey function. A key with a length between MIN_P2P_SIGNATURE_KEY_LEN and MAX_P2P_SIGNATURE_KEY_LEN can be set.

Run this function before running either the Session::CreateSession or Session::JoinSession functions. If a key is not set with this function even though the ConnectivityManager::StartNATSession function was called, an error occurs when the Session::CreateSession and Session::JoinSession functions execute.

When LANSessionDiscovery is enabled or VirtualSocketDriver is set, the P2P session key is cleared when you execute the Session::CreateSession or Session::JoinSession function.

See Also

ClearP2PDataPacketSessionSignatureKey()
GetP2PDataPacketSessionSignatureKeyPaylod()
GetP2PDataPacketSessionSignatureKeyLength()

Revision History

2012/07/11
Initial version.

CONFIDENTIAL