RTC_E_ Constants
RTC methods may return an RTC_E_ constant. These constants indicate the outcome of an API call.
The 32-bit values are laid out as follows:
3 3 2 2 2 2 2 2 2 2 2 2 1 1 1 1 1 1 1 1 1 1
1 0 9 8 7 6 5 4 3 2 1 0 9 8 7 6 5 4 3 2 1 0 9 8 7 6 5 4 3 2 1 0
---+-+-+-----------------------+-------------------------------+
Sev|C|R| Facility | Code |
---+-+-+-----------------------+-------------------------------+
Section | Description |
---|---|
Sev - Severity Code | 00 - Success (STATUS_SEVERITY_SUCCESS) |
01 - Informational | |
02 - RTC error (STATUS_SEVERITY_RTC_ERROR) | |
10 - Warning | |
11 - Error | |
C | Customer code flag |
R | Reserved bit |
Facility | Facility code
The FACILITY_RTC_INTERFACE facility code (0xEE) indicates RTC interface codes. The FACILITY_SIP_STATUS_CODE facility code (0xEF) indicates the SIP status codes. The FACILITY_PINT_STATUS_CODE facility code (0xF0) indicates the PINT status codes. |
Code | Facility's status code |
The following constants are the RTC interface return codes.
RTC_E_BASIC_AUTH_SET_TLS
0x80EE003FLMust set transport to TLS if Basic Authentication is allowed.
RTC_E_BAD_RLMI_DOCUMENT
0x80EE0086LThe RLMI Document is invalid.
RTC_E_CANNOT_ADD_SPECIFIC_DEVICE_TO_SESSION
0x80EE008BLCannot add a specific device to a session.
RTC_E_CLIENT_ALREADY_INITIALIZED
0x80EE0026LClient already initialized.
RTC_E_CLIENT_ALREADY_SHUT_DOWN
0x80EE0027LClient already shut down.
RTC_E_ANOTHER_MEDIA_SESSION_ACTIVE
0x80EE0077LAnother media session is active.
RTC_E_CLIENT_NOT_INITIALIZED
0x80EE0025LClient not initialized.
RTC_E_DESTINATION_ADDRESS_LOCAL
0x80EE0013LThe Destination Address belongs to the local machine.
RTC_E_DESTINATION_ADDRESS_MULTICAST
0x80EE0015LThe Destination Address is a multicast address.
RTC_E_DUPLICATE_BUDDY
0x80EE004ALBuddy already exists.
RTC_E_DUPLICATE_GROUP
0x80EE0052LGroup already exists.
RTC_E_DUPLICATE_REALM
0x80EE0043LDuplicate realm exists in an enabled profile.
RTC_E_DUPLICATE_WATCHER
0x80EE004BLWatcher already exists.
RTC_E_INVALID_ACL_LIST
0x80EE0050LACL list is invalid.
RTC_E_INVALID_ADDRESS_LOCAL
0x80EE0014LThe Local Address is invalid; check the profile.
RTC_E_INVALID_BUDDY_LIST
0x80EE004FLThe list of buddies is invalid.
RTC_E_INVALID_ID
0x80EE0087LThe endpoint ID is invalid.
RTC_E_INVALID_LISTEN_SOCKET
0x80EE007BLSpecified address and port are invalid.
RTC_E_INVALID_OBJECT_STATE
0x80EE0061LObject state does not allow this operation to be performed.
RTC_E_INVALID_PORTRANGE
0x80EE005CLInvalid port range.
RTC_E_INVALID_PREFERENCE_LIST
0x80EE0059LPreference list is invalid.
RTC_E_INVALID_PROFILE
0x80EE002ELInvalid profile.
RTC_E_INVALID_PROXY_ADDRESS
0x80EE0016LThe Proxy Address is not valid.
RTC_E_INVALID_REGISTRATION_STATE
0x80EE006DLInvalid registration state.
RTC_E_INVALID_SESSION_STATE
0x80EE002ALInvalid session state.
RTC_E_INVALID_SESSION_TYPE
0x80EE0029LInvalid session type.
RTC_E_INVALID_SIP_URL
0x80EE0012LThe SIP URL is not valid.
RTC_E_LOCAL_PHONE_NEEDED
0x80EE002CLA local phone number is needed.
RTC_E_LISTENING_SOCKET_NOT_EXIST
0x80EE007ALThe listening socket does not exist.
RTC_E_MALFORMED_XML
0x80EE004CLMalformed XML.
RTC_E_MAX_PENDING_OPERATIONS
0x80EE005ALMaximum number of pending operations reached.
RTC_E_MAX_PENDING_OPERATIONS
0x80EE005ALMaximum number of pending operations reached.
RTC_E_MAX_REDIRECTS
0x80EE0078LToo many redirects.
RTC_E_MEDIA_AEC
0x80EE0024LFailed to enable acoustic echo cancellation.
RTC_E_MEDIA_AUDIO_DEVICE_NOT_AVAILABLE
0x80EE0021LAudio device is not available.
RTC_E_MEDIA_CONTROLLER_STATE
0x80EE001FLOperation not allowed in current media controller state.
RTC_E_MEDIA_DISABLED
0x80EE006ELMedia is disabled.
RTC_E_MEDIA_ENABLED
0x80EE006FLMedia is enabled.
RTC_E_MEDIA_NEED_TERMINAL
0x80EE0020LCannot find device.
RTC_E_MEDIA_SESSION_IN_HOLD
0x80EE0076LMedia session is in hold.
RTC_E_MEDIA_SESSION_NOT_EXIST
0x80EE0075LMedia session does not exist.
RTC_E_MEDIA_VIDEO_DEVICE_NOT_AVAILABLE
0x80EE0022LVideo device is not available.
RTC_E_NO_BUDDY
0x80EE0054LBuddy does not exist.
RTC_E_NO_DEVICE
0x80EE002DLNo preferred device.
RTC_E_NO_GROUP
0x80EE0051LGroup does not exist.
RTC_E_NO_PROFILE
0x80EE002BLNo valid profile for this operation.
RTC_E_NO_REALM
0x80EE0056LNo realm is set.
RTC_E_NO_TRANSPORT
0x80EE0057LServer cannot be specified without a transport protocol.
RTC_E_NO_WATCHER
0x80EE0055LWatcher does not exist.
RTC_E_NOT_ALLOWED
0x80EE0082LThis action is not allowed.
RTC_E_NOT_EXIST
0x80EE0058LThe required item does not exist.
RTC_E_NOT_PRESENCE_PROFILE
0x80EE006ALA presence profile must be used.
RTC_E_OPERATION_WITH_TOO_MANY_PARTICIPANTS
0x80EE003ELThe operation failed because of too many participants in the session.
RTC_E_PLATFORM_NOT_SUPPORTED
0x80EE0080LThis operation is not supported on this Windows Platform.
RTC_E_POLICY_NOT_ALLOW
0x80EE0044LCurrent policy settings do not allow this action.
RTC_E_PORT_MANAGER_ALREADY_SET
0x80EE007CLThe port manager interface is already set.
RTC_E_PORT_MAPPING_UNAVAILABLE
0x80EE0045LPort mapping cannot be obtained from the port manager.
RTC_E_PORT_MAPPING_FAILED
0x80EE0046LPort mapping failure returned from the port mapper.
RTC_E_PRESENCE_ENABLED
0x80EE0062LPresence is enabled.
RTC_E_PRESENCE_NOT_ENABLED
0x80EE0028LPresence not enabled.
RTC_E_PROFILE_DUPLICATE_USER_URI_AND_SERVER
0x80EE008ALA profile with the same user URI and SIP server is already enabled.
RTC_E_PROFILE_INVALID_SERVER_AUTHMETHOD
0x80EE0038LInvalid server authentication method in profile.
RTC_E_PROFILE_INVALID_SERVER_PROTOCOL
0x80EE0037LInvalid server protocol in profile.
RTC_E_PROFILE_INVALID_SERVER_ROLE
0x80EE0039LInvalid server role in profile.
RTC_E_PROFILE_INVALID_SESSION
0x80EE003BLInvalid session tag in profile.
RTC_E_PROFILE_INVALID_SESSION_PARTY
0x80EE003CLInvalid session party in profile.
RTC_E_PROFILE_INVALID_SESSION_TYPE
0x80EE003DLInvalid session type in profile.
RTC_E_PROFILE_MULTIPLE_REGISTRARS
0x80EE003ALMultiple registrar servers in profile.
RTC_E_PROFILE_NO_KEY
0x80EE0030LNo profile URI.
RTC_E_PROFILE_NO_NAME
0x80EE0031LNo profile name.
RTC_E_PROFILE_NO_PROVISION
0x80EE002FLNo provision tag in profile.
RTC_E_PROFILE_NO_SERVER
0x80EE0034LNo server tag in profile.
RTC_E_PROFILE_NO_SERVER_ADDRESS
0x80EE0035LServer tag missing address in profile.
RTC_E_PROFILE_NO_SERVER_PROTOCOL
0x80EE0036LServer tag missing protocol in profile.
RTC_E_PROFILE_NO_USER
0x80EE0032LNo user tag in profile.
RTC_E_PROFILE_NO_USER_URI
0x80EE0033LNo user URI in profile.
RTC_E_PROFILE_SERVER_UNAUTHORIZED
0x80EE0042LServer address does not match an authorized domain in profile.
RTC_E_REDIRECT_PROCESSING_FAILED
0x80EE0079LProcessing redirect failed.
RTC_E_REFER_NOT_ACCEPTED
0x80EE0070LRefer has not been accepted.
RTC_E_REFER_NOT_ALLOWED
0x80EE0071LRefer operation is not allowed in this session.
RTC_E_REFER_NOT_EXIST
0x80EE0072LRefer session does not exist or has finished.
RTC_E_REGISTRATION_DEACTIVATED
0x80EE0083LThe user is being moved.
E_REGISTRATION_REJECTED
0x80EE0084LThe user's account was disabled or deleted or the SIP URI changed.
RTC_E_REGISTRATION_UNREGISTERED
0x80EE0085LThe user was logged out because the user logged in elsewhere.
RTC_E_ROAMING_ENABLED
0x80EE0063LRoaming is enabled.
RTC_E_ROAMING_FAILED
0x80EE004ELRoaming session failed.
RTC_E_ROAMING_OPERATION_INTERRUPTED
0x80EE004DLRoaming operation interrupted. It may succeed or fail.
RTC_E_SECURITY_LEVEL_NOT_SUPPORTED_BY_PARTICIPANT
0x80EE0049LParticipant could not support the requested security level.
RTC_E_SDP_CONNECTION_ADDR
0x80EE000ALMedia does not contain connection address.
RTC_E_SDP_FAILED_TO_BUILD
0x80EE000DLFailed to build SDP BLOB.
RTC_E_SDP_MULTICAST
0x80EE0009LMulticast is not supported.
RTC_E_SDP_NO_MEDIA
0x80EE000BLNo media is available for the session.
RTC_E_SDP_NOT_PRESENT
0x80EE0006LSDP is not present in the SIP message.
RTC_E_SDP_PARSE_FAILED
0x80EE0007LParsing SDP failed.
RTC_E_SDP_UPDATE_FAILED
0x80EE0008LSDP does not match the previous one.
RTC_E_SECURITY_LEVEL_ALREADY_SET
0x80EE007DLThe security level has already been set for this Media type and cannot be changed.
RTC_E_SECURITY_LEVEL_NOT_COMPATIBLE
0x80EE0047LThe local and remote security levels are not compatible.
RTC_E_SECURITY_LEVEL_NOT_DEFINED
0x80EE0048LParticipant could not support the requested security level.
RTC_E_SIP_ADDITIONAL_PARTY_IN_TWO_PARTY_SESSION
0x80EE005ELAdding additional parties to a two-party session failed.
RTC_E_SIP_AUTH_FAILED
0x80EE0011LAuthentication failed.
RTC_E_SIP_AUTH_HEADER_SENT
0x80EE000FLAuthorization header was sent in a previous request.
RTC_E_SIP_AUTH_INCORRECT_REALM
80EE0089LAuthentication failed because realm value in incoming message does not match realm value stored in profile.
RTC_E_SIP_AUTH_TIME_SKEW
0x80EE006CLAuthentication failure because of time skew between client and server.
RTC_E_SIP_AUTH_TYPE_NOT_SUPPORTED
0x80EE0010LThe Authentication type requested is not supported.
RTC_E_SIP_CALL_CONNECTION_NOT_ESTABLISHED
0x80EE005DLCall connection has not been established.
RTC_E_SIP_CALL_DISCONNECTED
0x80EE0019LThe call has been disconnected.
RTC_E_SIP_CODECS_DO_NOT_MATCH
0x80EE0000LNo matching codecs with peer.
RTC_E_SIP_DNS_FAIL
0x80EE0066LDNS lookup failed.
RTC_E_SIP_HEADER_NOT_PRESENT
0x80EE0005LThe SIP header is not present in the message.
RTC_E_SIP_HIGH_SECURITY_SET_TLS
0x80EE0040LMust set transport to TLS if high security model is needed.
RTC_E_SIP_HOLD_OPERATION_PENDING
0x80EE0073LA hold operation is currently pending.
RTC_E_SIP_INVALID_CERTIFICATE
0x80EE0065LInvalid certificate.
RTC_E_SIP_INVITE_TRANSACTION_PENDING
0x80EE000ELCurrently processing another INVITE transaction.
RTC_E_SIP_INVITEE_PARTY_TIMEOUT
0x80EE006BLInvitee connection fails.
RTC_E_SIP_NEED_MORE_DATA
0x80EE0018LNeed more data for parsing a whole SIP message.
RTC_E_SIP_NO_STREAM
0x80EE0003LNo stream is active.
RTC_E_SIP_OTHER_PARTY_JOIN_IN_PROGRESS
0x80EE0060LJoin operation is in progress for another party.
RTC_E_SIP_PARSE_FAILED
0x80EE0004LParsing SIP failed.
RTC_E_SIP_PARTY_ALREADY_IN_SESSION
0x80EE005FLParty already exists in session.
RTC_E_SIP_PEER_PARTICIPANT_IN_MULTIPARTY_SESSION
0x80EE0081LA peer participant cannot be added to a multiparty session.
RTC_E_SIP_REFER_OPERATION_PENDING
0x80EE007FLCurrently a refer operation is pending.
RTC_E_SIP_REQUEST_DESTINATION_ADDR_NOT_PRESENT
0x80EE001ALThe Request destination address is not known.
RTC_E_SIP_SSL_NEGOTIATION_TIMEOUT
0x80EE001DLTimeout during SSL negotiation.
RTC_E_SIP_SSL_TUNNEL_FAILED
0x80EE001CLCannot establish SSL tunnel to HTTP proxy.
RTC_E_SIP_STACK_SHUTDOWN
0x80EE001ELSIP Stack is already shut down.
RTC_E_SIP_STREAM_PRESENT
0x80EE0001LThe stream to be started is already present.
RTC_E_SIP_STREAM_NOT_PRESENT
0x80EE0002LThe stream to be stopped is not present.
RTC_E_SIP_TCP_FAIL
0x80EE0067LFailed to make a TCP connection.
RTC_E_SIP_TLS_FAIL
0x80EE0069LFailed to make a TLS connection.
RTC_E_SIP_TLS_INCOMPATIBLE_ENCRYPTION
0x80EE0064LIncompatible TLS encryption.
RTC_E_SIP_TIMEOUT
0x80EE000CLSIP Transaction timed out.
RTC_E_SIP_UNHOLD_OPERATION_PENDING
0x80EE0074LCurrently an unhold operation is pending.
RTC_E_TOO_MANY_GROUPS
0x80EE0053LMaximum number of groups has been reached.
RTC_E_SIP_TRANSPORT_NOT_SUPPORTED
0x80EE0017LThe Transport specified is not supported.
RTC_E_SIP_UDP_SIZE_EXCEEDED
0x80EE001BLThe SIP message size is greater than the UDP message size allowed.
RTC_E_START_STREAM
0x80EE0023LCannot start stream.
RTC_E_TOO_MANY_RETRIES
0x80EE005BLToo many attempt to resend a request.
RTC_E_TOO_MANY_GROUPS
0x80EE0053LMaximum number of groups has been reached.
RTC_E_TOO_SMALL_EXPIRES_VALUE
0x80EE0068LExpiration value received from server too small.
RTC_E_TRANSIENT_SERVER_DISCONNECT
0x80EE0088LThis operation failed because the server is unreachable or busy at this time. Please try again later.
RTC_E_UDP_NOT_SUPPORTED
0x80EE007ELThis feature is not supported when one of the servers in the profile has UDP transport.
The following constants are the SIP status code return values. The facility status code portion of the constant contains the SIP status code.
RTC_E_STATUS_CLIENT_ADDRESS_INCOMPLETE
0x80EF01E4LAddress Incomplete.
RTC_E_STATUS_CLIENT_AMBIGUOUS
0x80EF01E5LAmbiguous.
RTC_E_STATUS_CLIENT_BAD_EXTENSION
0x80EF01A4LBad Extension.
RTC_E_STATUS_CLIENT_BAD_REQUEST
0x80EF0190LBad Request.
RTC_E_STATUS_CLIENT_BUSY_HERE
0x80EF01E6LBusy Here.
RTC_E_STATUS_CLIENT_CONFLICT
0x80EF0199LConflict.
RTC_E_STATUS_CLIENT_FORBIDDEN
0x80EF0193LForbidden.
RTC_E_STATUS_CLIENT_GONE
0x80EF019ALGone.
RTC_E_STATUS_CLIENT_LENGTH_REQUIRED
0x80EF019BLLength Required.
RTC_E_STATUS_CLIENT_LOOP_DETECTED
0x80EF01E2LLoop Detected.
RTC_E_STATUS_CLIENT_METHOD_NOT_ALLOWED
0x80EF0195LMethod Not Allowed.
RTC_E_STATUS_CLIENT_NOT_ACCEPTABLE
0x80EF0196LNot Acceptable.
RTC_E_STATUS_CLIENT_NOT_FOUND
0x80EF0194LNot Found.
RTC_E_STATUS_CLIENT_PAYMENT_REQUIRED
0x80EF0192LPayment Required.
RTC_E_STATUS_CLIENT_PROXY_AUTHENTICATION_REQUIRED
0x80EF0197LProxy Authentication Required.
RTC_E_STATUS_CLIENT_REQUEST_ENTITY_TOO_LARGE
0x80EF019DLRequest Entity Too Large.
RTC_E_STATUS_CLIENT_REQUEST_TIMEOUT
0x80EF0198LRequest Time-out.
RTC_E_STATUS_CLIENT_REQUEST_URI_TOO_LARGE
0x80EF019ELRequest-URI Too Long.
RTC_E_STATUS_CLIENT_TEMPORARILY_NOT_AVAILABLE
0x80EF01E0LTemporarily Unavailable.
RTC_E_STATUS_CLIENT_TOO_MANY_HOPS
0x80EF01E3LToo Many Hops.
RTC_E_STATUS_CLIENT_TRANSACTION_DOES_NOT_EXIST
0x80EF01E1LCall Leg/Transaction Does Not Exist.
RTC_E_STATUS_CLIENT_UNAUTHORIZED
0x80EF0191LUnauthorized.
RTC_E_STATUS_CLIENT_UNSUPPORTED_MEDIA_TYPE
0x80EF019FLUnsupported Media Type.
RTC_E_STATUS_GLOBAL_BUSY_EVERYWHERE
0x80EF0258LBusy Everywhere.
RTC_E_STATUS_GLOBAL_DECLINE
0x80EF025BLDecline.
RTC_E_STATUS_GLOBAL_DOES_NOT_EXIST_ANYWHERE
0x80EF025CLDoes Not Exist Anywhere.
RTC_E_STATUS_GLOBAL_NOT_ACCEPTABLE
0x80EF025ELNot Acceptable.
RTC_E_STATUS_INFO_CALL_FORWARDING
0x00EF00B5LCall Is Being Forwarded.
RTC_E_STATUS_INFO_QUEUED
0x00EF00B6LQueued.
RTC_E_STATUS_INFO_RINGING
0x00EF00B4LRinging.
RTC_E_STATUS_INFO_TRYING
0x00EF0064LTrying.
RTC_E_STATUS_NOT_ACCEPTABLE_HERE
0x80EF01E8LNot Acceptable Here.
RTC_E_STATUS_REDIRECT_MULTIPLE_CHOICES
0x80EF012CLMultiple Choices.
RTC_E_STATUS_REDIRECT_MOVED_PERMANENTLY
0x80EF012DLMoved Permanently.
RTC_E_STATUS_REDIRECT_MOVED_TEMPORARILY
0x80EF012ELMoved Temporarily.
RTC_E_STATUS_REDIRECT_SEE_OTHER
0x80EF012FLSee Other.
RTC_E_STATUS_REDIRECT_USE_PROXY
0x80EF0131LUse Proxy.
RTC_E_STATUS_REDIRECT_ALTERNATIVE_SERVICE
0x80EF017CLAlternative Service.
RTC_E_STATUS_REQUEST_TERMINATED
0x80EF01E7L)Request Terminated.
RTC_E_STATUS_SERVER_BAD_GATEWAY
0x80EF01F6LBad Gateway.
RTC_E_STATUS_SERVER_INTERNAL_ERROR
0x80EF01F4LServer Internal Error.
RTC_E_STATUS_SERVER_NOT_IMPLEMENTED
0x80EF01F5LNot Implemented.
RTC_E_STATUS_SESSION_PROGRESS
0x00EF00B7LSession Progress.
RTC_E_STATUS_SERVER_SERVER_TIMEOUT
0x80EF01F8LServer Time-out.
RTC_E_STATUS_SERVER_SERVICE_UNAVAILABLE
0x80EF01F7LService Unavailable.
RTC_E_STATUS_SERVER_VERSION_NOT_SUPPORTED
0x80EF01F9LVersion Not Supported.
RTC_E_STATUS_SUCCESS
0x00EF00C8LOk.
RTC_S_ROAMING_NOT_SUPPORTED
0x00EE0041LServer does not support this type of roaming.
The following constants are the PINT (rfc 2848) status code return values. The facility status code portion of the constant contains the PINT status code.
RTC_E_PINT_STATUS_REJECTED_ALL_BUSY
0x80F00007LAll Busy.
RTC_E_PINT_STATUS_REJECTED_BADNUMBER
0x80F0000BLBad Number.
RTC_E_PINT_STATUS_REJECTED_BUSY
0x80F00005LBusy.
RTC_E_PINT_STATUS_REJECTED_CANCELLED
0x80F0000ALCancelled.
RTC_E_PINT_STATUS_REJECTED_NO_ANSWER
0x80F00006LNo Answer.
RTC_E_PINT_STATUS_REJECTED_PL_FAILED
0x80F00008LPrimary Leg Failed.
RTC_E_PINT_STATUS_REJECTED_SW_FAILED
0x80F00009LSwitch Failed.
Requirements
Client: Requires Windows XP.
Server: Requires Windows Server 2003.
Redistributable: Requires Rtcdll.dll on Windows 2000, and Windows ME/98.
Header: Declared in Rtccore.h.