RTC_REGISTRATION_STATE (Windows CE 5.0)
This enumeration defines possible client registration states. The IRTCProfile::State method uses this enumeration.
typedef enum RTC_REGISTRATION_STATE {RTCRS_NOT_REGISTERED,RTCRS_REGISTERING,RTCRS_REGISTERED,RTCRS_REJECTED,RTCRS_UNREGISTERING,RTCRS_ERROR,RTCRS_LOGGED_OFF,RTCRS_LOCAL_PA_LOGGED_OFF,RTCRS_REMOTE_PA_LOGGED_OFF} RTC_REGISTRATION_STATE;
Elements
- RTCRS_NOT_REGISTERED
The profile is not registered. The application called the IRTCClientProvisioning::DisableProfile method and has been successfully deregistered from the server. - RTCRS_REGISTERING
The profile is registering. The application has called IRTCClientProvisioning::EnableProfile or IRTCClientProvisioning2::EnableProfileEx and the SIP REGISTER message has been sent to the SIP server. - RTCRS_REGISTERED
The profile is registered. - RTCRS_REJECTED
The profile has been rejected. The server has rejected the SIP REGISTER request with a SIP failure response. The following table shows some common status codes for this state.Status code Description STATUS_CODE_SERVER_TIMEOUT (SIP 504 response) The domain part of the URI is wrong. RTC_E_STATUS_CLIENT_NOT_FOUND (SIP 404 response) The URI is wrong. RTC_E_STATUS_CLIENT_UNAUTHORIZED (SIP 401 response) The account name or password is incorrect. RTC_E_SIP_AUTH_TYPE_NOT_SUPPORTED The allowedauth attribute for this profile does not include the authentication type used by the SIP server, or the realm in the authentication challenge does not match the value set for this profile. RTC_E_SIP_DNS_FAIL No DNS record could be found for the SIP server specified for this profile. - RTCRS_UNREGISTERING
The profile is unregistering. The application called the IRTCClientProvisioning::DisableProfile method and the UNREGISTER SIP message has been sent to the SIP server. - RTCRS_ERROR
There has been an error registering the profile. - RTCRS_LOGGED_OFF
The server has removed the registration. Incoming requests will no longer be forwarded. One of the common reasons for this state is the user signing in with the SIP server from another device using the same user URI. - RTCRS_LOCAL_PA_LOGGED_OFF
The server has revoked the status as a presence agent for this user. Incoming presence subscriptions will no longer be forwarded. The presence status will no longer be visible to others from this client. - RTCRS_REMOTE_PA_LOGGED_OFF
The client that was the presence agent for this user has logged off. It may be possible to register as a presence agent from this client.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Rtccore.h.
See Also
RTC Client API Enumerations | IRTCClientProvisioning::DisableProfile | IRTCClientProvisioning::EnableProfile | IRTCClientProvisioning2::EnableProfileEx | IRTCProfile::State | IRTCRegistrationStateChangeEvent::State
Send Feedback on this topic to the authors