agora Namespace Reference

Namespaces
	base
	commons
	internal
	media
	rtc
	rtm
	util

Data Structures
class	agora_refptr
class	AtomicOps
struct	DataChannelConfig
struct	DataChannelInfo
class	IDataChannelObserver
class	ILocalDataChannel
struct	in_place_t
class	IRemoteDataChannel
struct	nullopt_t
class	Optional
class	RefCountedObject
class	RefCounter
class	RefCountInterface
struct	UserDataChannelInfo
struct	UserInfo
struct	VideoLayout

Enumerations
enum	WARN_CODE_TYPE {   WARN_INVALID_VIEW = 8, WARN_INIT_VIDEO = 16, WARN_PENDING = 20, WARN_NO_AVAILABLE_CHANNEL = 103,   WARN_LOOKUP_CHANNEL_TIMEOUT = 104, WARN_LOOKUP_CHANNEL_REJECTED = 105, WARN_OPEN_CHANNEL_TIMEOUT = 106, WARN_OPEN_CHANNEL_REJECTED = 107,   WARN_SWITCH_LIVE_VIDEO_TIMEOUT = 111, WARN_SET_CLIENT_ROLE_TIMEOUT = 118, WARN_OPEN_CHANNEL_INVALID_TICKET = 121, WARN_OPEN_CHANNEL_TRY_NEXT_VOS = 122,   WARN_CHANNEL_CONNECTION_UNRECOVERABLE = 131, WARN_CHANNEL_CONNECTION_IP_CHANGED = 132, WARN_CHANNEL_CONNECTION_PORT_CHANGED = 133, WARN_CHANNEL_SOCKET_ERROR = 134,   WARN_AUDIO_MIXING_OPEN_ERROR = 701, WARN_ADM_RUNTIME_PLAYOUT_WARNING = 1014, WARN_ADM_RUNTIME_RECORDING_WARNING = 1016, WARN_ADM_RECORD_AUDIO_SILENCE = 1019,   WARN_ADM_PLAYOUT_MALFUNCTION = 1020, WARN_ADM_RECORD_MALFUNCTION = 1021, WARN_ADM_RECORD_AUDIO_LOWLEVEL = 1031, WARN_ADM_PLAYOUT_AUDIO_LOWLEVEL = 1032,   WARN_ADM_WINDOWS_NO_DATA_READY_EVENT = 1040, WARN_APM_HOWLING = 1051, WARN_ADM_GLITCH_STATE = 1052, WARN_ADM_IMPROPER_SETTINGS = 1053,   WARN_ADM_POP_STATE = 1055, WARN_ADM_WIN_CORE_NO_RECORDING_DEVICE = 1322, WARN_ADM_WIN_CORE_NO_PLAYOUT_DEVICE = 1323, WARN_ADM_WIN_CORE_IMPROPER_CAPTURE_RELEASE = 1324 }
enum	ERROR_CODE_TYPE {   ERR_OK = 0, ERR_FAILED = 1, ERR_INVALID_ARGUMENT = 2, ERR_NOT_READY = 3,   ERR_NOT_SUPPORTED = 4, ERR_REFUSED = 5, ERR_BUFFER_TOO_SMALL = 6, ERR_NOT_INITIALIZED = 7,   ERR_INVALID_STATE = 8, ERR_NO_PERMISSION = 9, ERR_TIMEDOUT = 10, ERR_CANCELED = 11,   ERR_TOO_OFTEN = 12, ERR_BIND_SOCKET = 13, ERR_NET_DOWN = 14, ERR_JOIN_CHANNEL_REJECTED = 17,   ERR_LEAVE_CHANNEL_REJECTED = 18, ERR_ALREADY_IN_USE = 19, ERR_ABORTED = 20, ERR_INIT_NET_ENGINE = 21,   ERR_RESOURCE_LIMITED = 22, ERR_FUNC_IS_PROHIBITED = 23, ERR_INVALID_APP_ID = 101, ERR_INVALID_CHANNEL_NAME = 102,   ERR_NO_SERVER_RESOURCES = 103, ERR_TOKEN_EXPIRED = 109, ERR_INVALID_TOKEN = 110, ERR_CONNECTION_INTERRUPTED = 111,   ERR_CONNECTION_LOST = 112, ERR_NOT_IN_CHANNEL = 113, ERR_SIZE_TOO_LARGE = 114, ERR_BITRATE_LIMIT = 115,   ERR_TOO_MANY_DATA_STREAMS = 116, ERR_STREAM_MESSAGE_TIMEOUT = 117, ERR_SET_CLIENT_ROLE_NOT_AUTHORIZED = 119, ERR_DECRYPTION_FAILED = 120,   ERR_INVALID_USER_ID = 121, ERR_DATASTREAM_DECRYPTION_FAILED = 122, ERR_CLIENT_IS_BANNED_BY_SERVER = 123, ERR_ENCRYPTED_STREAM_NOT_ALLOWED_PUBLISH = 130,   ERR_LICENSE_CREDENTIAL_INVALID = 131, ERR_INVALID_USER_ACCOUNT = 134, ERR_MODULE_NOT_FOUND = 157 , ERR_PCMSEND_FORMAT = 200,   ERR_PCMSEND_BUFFEROVERFLOW = 201, ERR_LOAD_MEDIA_ENGINE = 1001, ERR_ADM_GENERAL_ERROR = 1005, ERR_ADM_INIT_PLAYOUT = 1008,   ERR_ADM_START_PLAYOUT = 1009, ERR_ADM_STOP_PLAYOUT = 1010, ERR_ADM_INIT_RECORDING = 1011, ERR_ADM_START_RECORDING = 1012,   ERR_ADM_STOP_RECORDING = 1013, ERR_VDM_CAMERA_NOT_AUTHORIZED = 1501 }

Typedef Documentation

user_id_t

typedef const char* user_id_t

view_t

typedef void* view_t

UserList

typedef util::AList<UserInfo> UserList

Enumeration Type Documentation

CHANNEL_PROFILE_TYPE

enum CHANNEL_PROFILE_TYPE

The channel profile.

Enumerator
CHANNEL_PROFILE_COMMUNICATION	0: Communication. Use this profile when there are only two users in the channel.
CHANNEL_PROFILE_LIVE_BROADCASTING	1: Live streaming. Use this profile when there are more than two users in the channel.
CHANNEL_PROFILE_GAME	2: Gaming. Deprecated: This profile is deprecated.
CHANNEL_PROFILE_CLOUD_GAMING	Cloud gaming. The scenario is optimized for latency. Use this profile if the use case requires frequent interactions between users. Deprecated: This profile is deprecated.
CHANNEL_PROFILE_COMMUNICATION_1v1	4: Communication 1v1. Deprecated: This profile is deprecated.

WARN_CODE_TYPE

enum WARN_CODE_TYPE

The warning codes.

Enumerator
WARN_INVALID_VIEW	8: The specified view is invalid. To use the video function, you need to specify a valid view.
WARN_INIT_VIDEO	16: Fails to initialize the video function, probably due to a lack of resources. Users fail to see each other, but can still communicate with voice.
WARN_PENDING	20: The request is pending, usually because some module is not ready, and the SDK postpones processing the request.
WARN_NO_AVAILABLE_CHANNEL	103: No channel resources are available, probably because the server cannot allocate any channel resource.
WARN_LOOKUP_CHANNEL_TIMEOUT	104: A timeout occurs when looking for the channel. When joining a channel, the SDK looks up the specified channel. This warning usually occurs when the network condition is too poor to connect to the server.
WARN_LOOKUP_CHANNEL_REJECTED	105: The server rejects the request to look for the channel. The server cannot process this request or the request is illegal.
WARN_OPEN_CHANNEL_TIMEOUT	106: A timeout occurs when opening the channel. Once the specific channel is found, the SDK opens the channel. This warning usually occurs when the network condition is too poor to connect to the server.
WARN_OPEN_CHANNEL_REJECTED	107: The server rejects the request to open the channel. The server cannot process this request or the request is illegal.
WARN_SWITCH_LIVE_VIDEO_TIMEOUT	111: A timeout occurs when switching the live video.
WARN_SET_CLIENT_ROLE_TIMEOUT	118: A timeout occurs when setting the user role.
WARN_OPEN_CHANNEL_INVALID_TICKET	121: The ticket to open the channel is invalid.
WARN_OPEN_CHANNEL_TRY_NEXT_VOS	122: The SDK is trying connecting to another server.
WARN_CHANNEL_CONNECTION_UNRECOVERABLE	131: The channel connection cannot be recovered.
WARN_CHANNEL_CONNECTION_IP_CHANGED	132: The SDK connection IP has changed.
WARN_CHANNEL_CONNECTION_PORT_CHANGED	133: The SDK connection port has changed.
WARN_CHANNEL_SOCKET_ERROR	134: The socket error occurs, try to rejoin channel.
WARN_AUDIO_MIXING_OPEN_ERROR	701: An error occurs when opening the file for audio mixing.
WARN_ADM_RUNTIME_PLAYOUT_WARNING	1014: Audio Device Module: An exception occurs in the playback device.
WARN_ADM_RUNTIME_RECORDING_WARNING	1016: Audio Device Module: A warning occurs in the recording device.
WARN_ADM_RECORD_AUDIO_SILENCE	1019: Audio Device Module: No valid audio data is collected.
WARN_ADM_PLAYOUT_MALFUNCTION	1020: Audio Device Module: The playback device fails to start.
WARN_ADM_RECORD_MALFUNCTION	1021: Audio Device Module: The recording device fails to start.
WARN_ADM_RECORD_AUDIO_LOWLEVEL	1031: Audio Device Module: The recorded audio volume is too low.
WARN_ADM_PLAYOUT_AUDIO_LOWLEVEL	1032: Audio Device Module: The playback audio volume is too low.
WARN_ADM_WINDOWS_NO_DATA_READY_EVENT	1040: Audio device module: An exception occurs with the audio drive. Choose one of the following solutions: Disable or re-enable the audio device. Re-enable your device. Update the sound card drive.
WARN_APM_HOWLING	1051: Audio Device Module: The SDK detects howling.
WARN_ADM_GLITCH_STATE	1052: Audio Device Module: The audio device is in a glitching state.
WARN_ADM_IMPROPER_SETTINGS	1053: Audio Device Module: The settings are improper.
WARN_ADM_POP_STATE	1055: Audio Device Module: The audio device is in a pop state.
WARN_ADM_WIN_CORE_NO_RECORDING_DEVICE	1322: No recording device.
WARN_ADM_WIN_CORE_NO_PLAYOUT_DEVICE	1323: Audio device module: No available playback device. You can try plugging in the audio device.
WARN_ADM_WIN_CORE_IMPROPER_CAPTURE_RELEASE	1324: Audio device module: The capture device is released improperly. Choose one of the following solutions: Disable or re-enable the audio device. Re-enable your audio device. Update the sound card drive.

ERROR_CODE_TYPE

enum ERROR_CODE_TYPE

Error codes.

An error code indicates that the SDK encountered an unrecoverable error that requires application intervention. For example, an error is returned when the camera fails to open, and the app needs to inform the user that the camera cannot be used.

Enumerator
ERR_OK	0: No error.
ERR_FAILED	1: General error with no classified reason. Try calling the method again.
ERR_INVALID_ARGUMENT	2: An invalid parameter is used. For example, the specified channel name includes illegal characters. Reset the parameter.
ERR_NOT_READY	3: The SDK is not ready. Possible reasons include the following: The initialization of IRtcEngine fails. Reinitialize the IRtcEngine. No user has joined the channel when the method is called. Check the code logic. The user has not left the channel when the rate or complain method is called. Check the code logic. The audio module is disabled. The program is not complete.
ERR_NOT_SUPPORTED	4: The IRtcEngine does not support the request. Possible reasons include the following: The built-in encryption mode is incorrect, or the SDK fails to load the external encryption library. Check the encryption mode setting, or reload the external encryption library.
ERR_REFUSED	5: The request is rejected. Possible reasons include the following: The IRtcEngine initialization fails. Reinitialize the IRtcEngine. The channel name is set as the empty string "" when joining the channel. Reset the channel name. When the joinChannelEx method is called to join multiple channels, the specified channel name is already in use. Reset the channel name.
ERR_BUFFER_TOO_SMALL	6: The buffer size is insufficient to store the returned data.
ERR_NOT_INITIALIZED	7: A method is called before the initialization of IRtcEngine. Ensure that the IRtcEngine object is initialized before using this method.
ERR_INVALID_STATE	8: Invalid state.
ERR_NO_PERMISSION	9: Permission to access is not granted. Check whether your app has access to the audio and video device.
ERR_TIMEDOUT	10: A timeout occurs. Some API calls require the SDK to return the execution result. This error occurs if the SDK takes too long (more than 10 seconds) to return the result.
ERR_CANCELED	11: The request is cancelled. This is for internal use only, and does not return to the app through any method or callback.
ERR_TOO_OFTEN	12: The method is called too often. This is for internal use only, and does not return to the app through any method or callback.
ERR_BIND_SOCKET	13: The SDK fails to bind to the network socket. This is for internal use only, and does not return to the app through any method or callback.
ERR_NET_DOWN	14: The network is unavailable. This is for internal use only, and does not return to the app through any method or callback.
ERR_JOIN_CHANNEL_REJECTED	17: The request to join the channel is rejected. Possible reasons include the following: The user is already in the channel. Agora recommends that you use the onConnectionStateChanged callback to see whether the user is in the channel. Do not call this method to join the channel unless you receive the CONNECTION_STATE_DISCONNECTED (1) state. After calling startEchoTest for the call test, the user tries to join the channel without calling stopEchoTest to end the current test. To join a channel, the call test must be ended by calling stopEchoTest.
ERR_LEAVE_CHANNEL_REJECTED	18: Fails to leave the channel. Possible reasons include the following: The user has left the channel before calling the leaveChannel(const LeaveChannelOptions& options) method. Stop calling this method to clear this error. The user calls the leaveChannel(const LeaveChannelOptions& options) method to leave the channel before joining the channel. In this case, no extra operation is needed.
ERR_ALREADY_IN_USE	19: Resources are already in use.
ERR_ABORTED	20: The request is abandoned by the SDK, possibly because the request has been sent too frequently.
ERR_INIT_NET_ENGINE	21: The IRtcEngine fails to initialize and has crashed because of specific Windows firewall settings.
ERR_RESOURCE_LIMITED	22: The SDK fails to allocate resources because your app uses too many system resources or system resources are insufficient.
ERR_FUNC_IS_PROHIBITED	23: The function is prohibited. Please allow it in the console, or contact the Agora technical support. @technical preview
ERR_INVALID_APP_ID	101: The specified App ID is invalid. Rejoin the channel with a valid App ID.
ERR_INVALID_CHANNEL_NAME	102: The specified channel name is invalid. A possible reason is that the parameter's data type is incorrect. Rejoin the channel with a valid channel name.
ERR_NO_SERVER_RESOURCES	103: Fails to get server resources in the specified region. Try another region when initializing IRtcEngine.
ERR_TOKEN_EXPIRED	109: The current token has expired. Apply for a new token on the server and call renewToken.
ERR_INVALID_TOKEN	110: Invalid token. Typical reasons include the following: App Certificate is enabled in Agora Console, but the code still uses App ID for authentication. Once App Certificate is enabled for a project, you must use token-based authentication. The uid used to generate the token is not the same as the uid used to join the channel.
ERR_CONNECTION_INTERRUPTED	111: The network connection is interrupted. The SDK triggers this callback when it loses connection with the server for more than four seconds after the connection is established.
ERR_CONNECTION_LOST	112: The network connection is lost. Occurs when the SDK cannot reconnect to Agora's edge server 10 seconds after its connection to the server is interrupted.
ERR_NOT_IN_CHANNEL	113: The user is not in the channel when calling the sendStreamMessage method.
ERR_SIZE_TOO_LARGE	114: The data size exceeds 1 KB when calling the sendStreamMessage method.
ERR_BITRATE_LIMIT	115: The data bitrate exceeds 6 KB/s when calling the sendStreamMessage method.
ERR_TOO_MANY_DATA_STREAMS	116: More than five data streams are created when calling the createDataStream(int* streamId, const DataStreamConfig& config) method.
ERR_STREAM_MESSAGE_TIMEOUT	117: The data stream transmission times out.
ERR_SET_CLIENT_ROLE_NOT_AUTHORIZED	119: Switching roles fails, try rejoining the channel.
ERR_DECRYPTION_FAILED	120: Media streams decryption fails. The user might use an incorrect password to join the channel. Check the entered password, or tell the user to try rejoining the channel.
ERR_INVALID_USER_ID	121: The user ID is invalid.
ERR_DATASTREAM_DECRYPTION_FAILED	122: Data streams decryption fails. The user might use an incorrect password to join the channel. Check the entered password, or tell the user to try rejoining the channel.
ERR_CLIENT_IS_BANNED_BY_SERVER	123: The user is banned from the server.
ERR_ENCRYPTED_STREAM_NOT_ALLOWED_PUBLISH	130: The SDK does not support pushing encrypted streams to CDN.
ERR_LICENSE_CREDENTIAL_INVALID	131: License credential is invalid
ERR_INVALID_USER_ACCOUNT	134: The user account is invalid, possibly because it contains invalid parameters.
ERR_MODULE_NOT_FOUND	157: The necessary dynamical library is not integrated. For example, if you call the enableDeepLearningDenoise but do not integrate the dynamical library for the deep-learning noise reduction into your project, the SDK reports this error code.
ERR_CERT_RAW
ERR_CERT_JSON_PART
ERR_CERT_JSON_INVAL
ERR_CERT_JSON_NOMEM
ERR_CERT_CUSTOM
ERR_CERT_CREDENTIAL
ERR_CERT_SIGN
ERR_CERT_FAIL
ERR_CERT_BUF
ERR_CERT_NULL
ERR_CERT_DUEDATE
ERR_CERT_REQUEST
ERR_PCMSEND_FORMAT	200: Unsupported PCM format.
ERR_PCMSEND_BUFFEROVERFLOW	201: Buffer overflow, the PCM send rate too quickly.
ERR_LOAD_MEDIA_ENGINE	1001: The SDK fails to load the media engine.
ERR_ADM_GENERAL_ERROR	1005: A general error occurs (no specified reason). Check whether the audio device is already in use by another app, or try rejoining the channel.
ERR_ADM_INIT_PLAYOUT	1008: An error occurs when initializing the playback device. Check whether the playback device is already in use by another app, or try rejoining the channel.
ERR_ADM_START_PLAYOUT	1009: An error occurs when starting the playback device. Check the playback device.
ERR_ADM_STOP_PLAYOUT	1010: An error occurs when stopping the playback device.
ERR_ADM_INIT_RECORDING	1011: An error occurs when initializing the recording device. Check the recording device, or try rejoining the channel.
ERR_ADM_START_RECORDING	1012: An error occurs when starting the recording device. Check the recording device.
ERR_ADM_STOP_RECORDING	1013: An error occurs when stopping the recording device.
ERR_VDM_CAMERA_NOT_AUTHORIZED	1501: Permission to access the camera is not granted. Check whether permission to access the camera permission is granted.

LICENSE_ERROR_TYPE

enum LICENSE_ERROR_TYPE

Enumerator
LICENSE_ERR_INVALID	1: Invalid license
LICENSE_ERR_EXPIRE	2: License expired
LICENSE_ERR_MINUTES_EXCEED	3: Exceed license minutes limit
LICENSE_ERR_LIMITED_PERIOD	4: License use in limited period
LICENSE_ERR_DIFF_DEVICES	5: Same license used in different devices at the same time
LICENSE_ERR_INTERNAL	99: SDK internal error

AUDIO_SESSION_OPERATION_RESTRICTION

enum AUDIO_SESSION_OPERATION_RESTRICTION

The operation permissions of the SDK on the audio session.

Enumerator
AUDIO_SESSION_OPERATION_RESTRICTION_NONE	0: No restriction, the SDK can change the audio session.
AUDIO_SESSION_OPERATION_RESTRICTION_SET_CATEGORY	1: The SDK cannot change the audio session category.
AUDIO_SESSION_OPERATION_RESTRICTION_CONFIGURE_SESSION	2: The SDK cannot change the audio session category, mode, or categoryOptions.
AUDIO_SESSION_OPERATION_RESTRICTION_DEACTIVATE_SESSION	4: The SDK keeps the audio session active when the user leaves the channel, for example, to play an audio file in the background.
AUDIO_SESSION_OPERATION_RESTRICTION_ALL	128: Completely restricts the operation permissions of the SDK on the audio session; the SDK cannot change the audio session.

Function Documentation

make_refptr() [1/2]

agora_refptr<T> agora::make_refptr ( )

inline

make_refptr() [2/2]

agora_refptr<T> agora::make_refptr ( const P0 &  p0 )

inline

nullopt()

const nullopt_t agora::nullopt

(

0

)

operator==() [1/5]

bool agora::operator==	(	const Optional< T > &	lhs,
		const Optional< U > &	rhs
	)

operator!=() [1/5]

bool agora::operator!=	(	const Optional< T > &	lhs,
		const Optional< U > &	rhs
	)

operator<() [1/5]

bool agora::operator<	(	const Optional< T > &	lhs,
		const Optional< U > &	rhs
	)

operator<=() [1/5]

bool agora::operator<=	(	const Optional< T > &	lhs,
		const Optional< U > &	rhs
	)

operator>() [1/5]

bool agora::operator>	(	const Optional< T > &	lhs,
		const Optional< U > &	rhs
	)

operator>=() [1/5]

bool agora::operator>=	(	const Optional< T > &	lhs,
		const Optional< U > &	rhs
	)

operator==() [2/5]

CONSTEXPR bool agora::operator==	(	const Optional< T > &	opt,
		nullopt_t
	)

operator==() [3/5]

CONSTEXPR bool agora::operator==	(	nullopt_t	,
		const Optional< T > &	opt
	)

operator!=() [2/5]

CONSTEXPR bool agora::operator!=	(	const Optional< T > &	opt,
		nullopt_t
	)

operator!=() [3/5]

CONSTEXPR bool agora::operator!=	(	nullopt_t	,
		const Optional< T > &	opt
	)

operator<() [2/5]

CONSTEXPR bool agora::operator<	(	const Optional< T > &	,
		nullopt_t
	)

operator<() [3/5]

CONSTEXPR bool agora::operator<	(	nullopt_t	,
		const Optional< T > &	opt
	)

operator<=() [2/5]

CONSTEXPR bool agora::operator<=	(	const Optional< T > &	opt,
		nullopt_t
	)

operator<=() [3/5]

CONSTEXPR bool agora::operator<=	(	nullopt_t	,
		const Optional< T > &
	)

operator>() [2/5]

CONSTEXPR bool agora::operator>	(	const Optional< T > &	opt,
		nullopt_t
	)

operator>() [3/5]

CONSTEXPR bool agora::operator>	(	nullopt_t	,
		const Optional< T > &
	)

operator>=() [2/5]

CONSTEXPR bool agora::operator>=	(	const Optional< T > &	,
		nullopt_t
	)

operator>=() [3/5]

CONSTEXPR bool agora::operator>=	(	nullopt_t	,
		const Optional< T > &	opt
	)

operator==() [4/5]

CONSTEXPR bool agora::operator==	(	const Optional< T > &	opt,
		const U &	value
	)

operator==() [5/5]

CONSTEXPR bool agora::operator==	(	const U &	value,
		const Optional< T > &	opt
	)

operator!=() [4/5]

CONSTEXPR bool agora::operator!=	(	const Optional< T > &	opt,
		const U &	value
	)

operator!=() [5/5]

CONSTEXPR bool agora::operator!=	(	const U &	value,
		const Optional< T > &	opt
	)

operator<() [4/5]

CONSTEXPR bool agora::operator<	(	const Optional< T > &	opt,
		const U &	value
	)

operator<() [5/5]

CONSTEXPR bool agora::operator<	(	const U &	value,
		const Optional< T > &	opt
	)

operator<=() [4/5]

CONSTEXPR bool agora::operator<=	(	const Optional< T > &	opt,
		const U &	value
	)

operator<=() [5/5]

CONSTEXPR bool agora::operator<=	(	const U &	value,
		const Optional< T > &	opt
	)

operator>() [4/5]

CONSTEXPR bool agora::operator>	(	const Optional< T > &	opt,
		const U &	value
	)

operator>() [5/5]

CONSTEXPR bool agora::operator>	(	const U &	value,
		const Optional< T > &	opt
	)

operator>=() [4/5]

CONSTEXPR bool agora::operator>=	(	const Optional< T > &	opt,
		const U &	value
	)

operator>=() [5/5]

CONSTEXPR bool agora::operator>=	(	const U &	value,
		const Optional< T > &	opt
	)

swap()

void agora::swap	(	Optional< T > &	lhs,
		Optional< T > &	rhs
	)

Variable Documentation

in_place

const in_place_t in_place = {}

RefCountReleaseStatus

OPTIONAL_ENUM_CLASS RefCountReleaseStatus { kDroppedLastRef, kOtherRefsRemained }