Meeting SDK for Windows API Reference
Loading...
Searching...
No Matches
auth_service_interface.h
Go to the documentation of this file.
1
6#ifndef _AUTH_SERVICE_INTERFACE_H_
7#define _AUTH_SERVICE_INTERFACE_H_
8#include "zoom_sdk_def.h"
9
11
44
59
96#if defined(WIN32)
113
143
144#endif
145
149typedef struct tagAuthContext
150{
177 {
178 jwt_token = nullptr;
179 }
180
182
193
198{
199public:
204 virtual const zchar_t* GetDisplayName() = 0;
209 virtual LoginType GetLoginType() = 0;
210 virtual ~IAccountInfo(){};
211};
212
217{
218public:
220
225 virtual void onAuthenticationReturn(AuthResult ret) = 0;
226
233 virtual void onLoginReturnWithReason(LOGINSTATUS ret, IAccountInfo* pAccountInfo, LoginFailReason reason) = 0;
234
238 virtual void onLogout() = 0;
239
243 virtual void onZoomIdentityExpired() = 0;
244
248 virtual void onZoomAuthIdentityExpired() = 0;
249#if defined(WIN32)
256#endif
257};
258#if defined(WIN32)
260class IOutlookPluginIntegrationHelper;
262#endif
267{
268public:
274 virtual SDKError SetEvent(IAuthServiceEvent* pEvent) = 0;
275
281 virtual SDKError SDKAuth(AuthContext& authContext) = 0;
282
288
293 virtual const zchar_t* GetSDKIdentity() = 0;
294
298
302 virtual const zchar_t* GenerateSSOLoginWebURL(const zchar_t* prefix_of_vanity_url) = 0;
303
310 virtual SDKError SSOLoginWithWebUriProtocol(const zchar_t* uri_protocol) = 0;
311
313
318 virtual SDKError LogOut() = 0;
319
325
331#if defined(WIN32)
337
342 virtual void EnableAutoRegisterNotificationServiceForLogin(bool bEnable) = 0;
343
349 virtual SDKError RegisterNotificationService(const zchar_t* accessToken) = 0;
350
356
362#endif
363};
365#endif
LoginType
Enumeration of user login type.
@ LoginType_Unknown
SDKNotificationServiceError
Enumeration of notification service error codes.
@ SDK_Notification_Service_Error_Unknown
Unknown error.
@ SDK_Notification_Service_Error_Multi_Connect
Multiple connections detected.
@ SDK_Notification_Service_Error_Max_Duration
The client has been connected for too long (over 24 hours).
@ SDK_Notification_Service_Error_Invalid_Token
Invalid token.
@ SDK_Notification_Service_Error_Success
Success.
@ SDK_Notification_Service_Error_Internal_Error
Internal error,need retry.
@ SDK_Notification_Service_Error_Network_Issue
Network issue.
struct tagAuthContext AuthContext
SDK authentication parameter with jwt token.
LOGINSTATUS
Enumeration of SDK login status.
@ LOGIN_PROCESSING
LoginFailReason
Enumeration of SDK login failed reason.
@ LoginFail_SMSCodeError
@ LoginFail_OtherIssue
@ LoginFail_Mfa_Required
@ LoginFail_PhoneNumberFormatInValid
@ LoginFail_SMSCodeExpired
@ LoginFail_Need_Bitrthday_ask
@ LoginFail_SDKNeedUpdate
@ LoginFail_LoginTokenInvalid
@ LoginFail_WrongPassword
@ LoginFail_EmailLoginDisable
@ LoginFail_UserDisagreeLoginDisclaimer
@ LoginFail_UserNotExist
@ LoginFail_TooManyFailedAttempts
@ LoginFail_AccountLocked
AuthResult
Enumeration of SDK authentication result.
@ AUTHRET_UNKNOWN
@ AUTHRET_OVERTIME
@ AUTHRET_SERVICE_BUSY
@ AUTHRET_SUCCESS
@ AUTHRET_LIMIT_EXCEEDED_EXCEPTION
@ AUTHRET_JWTTOKENWRONG
@ AUTHRET_ACCOUNTNOTSUPPORT
@ AUTHRET_KEYORSECRETEMPTY
@ AUTHRET_NETWORKISSUE
@ AUTHRET_ACCOUNTNOTENABLESDK
@ AUTHRET_CLIENT_INCOMPATIBLE
@ AUTHRET_KEYORSECRETWRONG
SDKNotificationServiceStatus
Enumeration of the type for notification service status.
@ SDK_Notification_Service_Started
@ SDK_Notification_Service_Closed
@ SDK_Notification_Service_StartFailed
@ SDK_Notification_Service_Starting
@ SDK_Notification_Service_None
Account information interface.
virtual const zchar_t * GetDisplayName()=0
Get the screen name of user.
virtual LoginType GetLoginType()=0
Get login type.
Authentication service callback event.
virtual void onNotificationServiceStatus(SDKNotificationServiceStatus status, SDKNotificationServiceError error)=0
Notification of service status changed.
virtual void onZoomIdentityExpired()=0
Notification of Zoom identity has expired, please re-login or generate a new zoom access token via RE...
virtual void onLoginReturnWithReason(LOGINSTATUS ret, IAccountInfo *pAccountInfo, LoginFailReason reason)=0
Notification of login result with fail reason.
virtual void onAuthenticationReturn(AuthResult ret)=0
Notification of authentication result.
virtual void onZoomAuthIdentityExpired()=0
Notification of Zoom authentication identity will be expired in 10 minutes, please re-auth.
virtual void onLogout()=0
Notification of logout.
Authentication Service Interface.
virtual AuthResult GetAuthResult()=0
Get authentication status.
virtual IDirectShareServiceHelper * GetDirectShareServiceHelper()=0
Get direct share service helper interface.
virtual SDKError SetEvent(IAuthServiceEvent *pEvent)=0
Set the authentication service callback event handler.
virtual SDKError RegisterNotificationService(const zchar_t *accessToken)=0
Register notification service.
virtual LOGINSTATUS GetLoginStatus()=0
Get login status.
virtual const zchar_t * GetSDKIdentity()=0
Get SDK identity.
virtual IAccountInfo * GetAccountInfo()=0
Get login account information.
virtual SDKError LogOut()=0
Account logout.
virtual SDKError SDKAuth(AuthContext &authContext)=0
SDK Authentication with jwt token.
virtual INotificationServiceHelper * GetNotificationServiceHelper()=0
Get notification service helper interface.
virtual void EnableAutoRegisterNotificationServiceForLogin(bool bEnable)=0
Enable or disable auto register notification service. This is enabled by default.
virtual SDKError UnregisterNotificationService()=0
UnRegister notification service.
Direct sharing helper Interface.
SDK authentication parameter with jwt token.
const zchar_t * jwt_token
JWT token. You may generate your JWT token using the online tool https://jwt.io/.
ZOOM windows SDK Common Definition File.
#define END_ZOOM_SDK_NAMESPACE
wchar_t zchar_t
#define BEGIN_ZOOM_SDK_NAMESPACE
SDKError
Enumeration of common errors of SDK.