windows-nt/Source/XPSP1/NT/enduser/netmeeting/h/t120/iappldr.h

126 lines
3 KiB
C
Raw Normal View History

2020-09-26 03:20:57 -05:00
#ifndef _I_APPLOADER_H
#define _I_APPLOADER_H
#include <basetyps.h>
#include "gcc.h"
typedef enum
{
APPLET_ID_WB = 0,
APPLET_ID_FT = 1,
APPLET_ID_CHAT = 2,
APPLET_LAST = 3,
}
APPLET_ID;
typedef enum
{
APPLDR_NO_ERROR = 0,
APPLDR_FAIL,
APPLDR_CANCEL_EXIT,
}
APPLDR_RESULT;
typedef enum
{
APPLET_QUERY_SHUTDOWN = 0,
APPLET_QUERY_NM2xNODE,
}
APPLET_QUERY_ID;
#undef INTERFACE
#define INTERFACE IAppletLoader
DECLARE_INTERFACE(IAppletLoader)
{
STDMETHOD_(void, ReleaseInterface)(THIS) PURE;
STDMETHOD_(APPLDR_RESULT, AppletStartup)(THIS_
IN BOOL fNoUI) PURE;
STDMETHOD_(APPLDR_RESULT, AppletCleanup)(THIS_
IN DWORD dwTimeout) PURE;
STDMETHOD_(APPLDR_RESULT, AppletInvoke)(THIS_
IN BOOL fLocal,
IN GCCConfID,
IN LPSTR pszCmdLine) PURE;
STDMETHOD_(APPLDR_RESULT, AppletQuery)(THIS_
IN APPLET_QUERY_ID eQueryId) PURE;
STDMETHOD_(APPLDR_RESULT, OnNM2xNodeJoin)(THIS) PURE;
};
typedef enum
{
APPLET_LIBRARY_FREED = 0,
APPLET_LIBRARY_LOADED,
APPLET_WORK_THREAD_STARTED,
APPLET_CLOSING,
APPLET_WORK_THREAD_EXITED,
}
APPLET_STATUS;
#define CREATE_APPLET_LOADER_INTERFACE "CreateAppletLoaderInterface"
typedef T120Error (WINAPI *LPFN_CREATE_APPLET_LOADER_INTERFACE) (IAppletLoader **);
#ifdef __cplusplus
extern "C" {
#endif
// caller: NM/UI, T.120
T120Error WINAPI T120_LoadApplet(APPLET_ID, BOOL fLocal, T120ConfID, BOOL fNoUI, LPSTR pszCmdLine);
// caller: NM/UI shutdown
T120Error WINAPI T120_CloseApplet(APPLET_ID, BOOL fNowRegardlessRefCount, BOOL fSync, DWORD dwTimeout);
// caller: applet itself
T120Error WINAPI T120_AppletStatus(APPLET_ID, APPLET_STATUS);
// caller: NM/UI
T120Error WINAPI T120_QueryApplet(APPLET_ID, APPLET_QUERY_ID);
// node ID --> user name
//
// Return value is zero (in case of failure)
// or the length of node name (in case of valid <conf ID, node ID>).
//
// The caller should check if the buffer size given is large enough to
// hold the entire node name. If not, the caller should provide a new buffer
// and call this function again in order to get the entire node name.
//
ULONG WINAPI T120_GetNodeName(T120ConfID, T120NodeID, LPSTR pszName, ULONG cchName);
// node ID + GUID --> user data
//
// Return value is zero (in case of failure)
// or the size of user data (in case of valid <conf ID, node ID, GUID>).
//
// The caller should check if the buffer size given is large enough to
// hold the entire user data. If not, the caller should provide a new buffer
// and call this function again in order to get the entire user data.
//
ULONG WINAPI T120_GetUserData(T120ConfID, T120NodeID, GUID *, LPBYTE pbBuffer, ULONG cbBufSize);
// node ID --> node version
//
// Node version (like NM 3.0) is maintained iinside CConf's NodeVersion list
// Given confId and node id, returns node's version number
//
DWORD_PTR WINAPI T120_GetNodeVersion(T120ConfID, T120NodeID);
#ifdef __cplusplus
}
#endif
#endif // _I_APPLOADER_H