//****************************************************************************
//
// Module: ULS.DLL
// File: ulsldap.h
// Content: This file contains the declaration for LDAP function calls
// History:
// Tue 08-Oct-1996 08:54:45 -by- Lon-Chan Chu [lonchanc]
//
// Copyright (c) Microsoft Corporation 1996-1997
//
//****************************************************************************
#ifndef _ILS_LDAP_H_
#define _ILS_LDAP_H_
#include <pshpack8.h>
//
// Asynchronous request result:
//
// **********************************************************************************
// Message wParam lParam
// **********************************************************************************
//
#define WM_ILS_ASYNC_RES (WM_USER+0x1001)
// client object
#define WM_ILS_REGISTER_CLIENT (WM_ILS_ASYNC_RES+0) // uMsgID hResult
#define WM_ILS_UNREGISTER_CLIENT (WM_ILS_ASYNC_RES+1) // uMsgID hResult
#define WM_ILS_SET_CLIENT_INFO (WM_ILS_ASYNC_RES+2) // uMsgID hResult
#define WM_ILS_RESOLVE_CLIENT (WM_ILS_ASYNC_RES+3)// uMsgID PLDAP_USERINFO_RES
#define WM_ILS_ENUM_CLIENTS (WM_ILS_ASYNC_RES+4)// uMsgID PLDAP_ENUM
#define WM_ILS_ENUM_CLIENTINFOS (WM_ILS_ASYNC_RES+5)// uMsgID PLDAP_ENUM
// protocol object
#define WM_ILS_REGISTER_PROTOCOL (WM_ILS_ASYNC_RES+6) // uMsgID hResult
#define WM_ILS_UNREGISTER_PROTOCOL (WM_ILS_ASYNC_RES+7) // uMsgID hResult
#define WM_ILS_SET_PROTOCOL_INFO (WM_ILS_ASYNC_RES+8) // uMsgID hResult
#define WM_ILS_RESOLVE_PROTOCOL (WM_ILS_ASYNC_RES+9)// uMsgID PLDAP_PROTINFO_RES
#define WM_ILS_ENUM_PROTOCOLS (WM_ILS_ASYNC_RES+10)// uMsgID PLDAP_ENUM
#ifdef ENABLE_MEETING_PLACE
// meeting object
#define WM_ILS_REGISTER_MEETING (WM_ILS_ASYNC_RES+11)
#define WM_ILS_UNREGISTER_MEETING (WM_ILS_ASYNC_RES+12)
#define WM_ILS_SET_MEETING_INFO (WM_ILS_ASYNC_RES+13)
#define WM_ILS_RESOLVE_MEETING (WM_ILS_ASYNC_RES+14)
#define WM_ILS_ENUM_MEETINGINFOS (WM_ILS_ASYNC_RES+15)
#define WM_ILS_ENUM_MEETINGS (WM_ILS_ASYNC_RES+16)
#define WM_ILS_ADD_ATTENDEE (WM_ILS_ASYNC_RES+17)
#define WM_ILS_REMOVE_ATTENDEE (WM_ILS_ASYNC_RES+18)
#define WM_ILS_ENUM_ATTENDEES (WM_ILS_ASYNC_RES+19)
#define WM_ILS_CANCEL (WM_ILS_ASYNC_RES+20)
#else
#define WM_ILS_CANCEL (WM_ILS_ASYNC_RES+11)
#endif
#define WM_ILS_LAST_ONE WM_ILS_CANCEL
// client notification
#define WM_ILS_CLIENT_NEED_RELOGON (WM_ILS_ASYNC_RES+51)// fPrimary pszServerName
#define WM_ILS_CLIENT_NETWORK_DOWN (WM_ILS_ASYNC_RES+52)// fPrimary pszServerName
#ifdef ENABLE_MEETING_PLACE
// meeting notification
#define WM_ILS_MEETING_NEED_RELOGON (WM_ILS_ASYNC_RES+61)
#define WM_ILS_MEETING_NETWORK_DOWN (WM_ILS_ASYNC_RES+62)
#endif
//
// Constants
//
#define INVALID_OFFSET 0
#define INVALID_USER_FLAGS -1 // used in LDAP_USERINFO dwFlags
#ifdef ENABLE_MEETING_PLACE
#define INVALID_MEETING_FLAGS 0 // used in LDAP_MEETINFO dwFlags
#define INVALID_MEETING_TYPE 0 // used in LDAP_MEETINFO lMeetingType
#define INVALID_ATTENDEE_TYPE 0 // used in LDAP_MEETINFO lAttendeeType
#endif
//
// Asynchronous response info structures
//
typedef struct tagLDAPAsyncInfo
{
ULONG uMsgID;
}
LDAP_ASYNCINFO, *PLDAP_ASYNCINFO;
typedef struct tagLDAPEnum
{
ULONG uSize;
HRESULT hResult;
ULONG cItems;
ULONG uOffsetItems;
}
LDAP_ENUM, *PLDAP_ENUM;
typedef struct tagLDAPClientInfo
{
ULONG uSize;
// user object attributes
ULONG uOffsetCN;
ULONG uOffsetFirstName;
ULONG uOffsetLastName;
ULONG uOffsetEMailName;
ULONG uOffsetCityName;
ULONG uOffsetCountryName;
ULONG uOffsetComment;
ULONG uOffsetIPAddress;
DWORD dwFlags; // 0, private; 1, public
// app object attributes
ULONG uOffsetAppName;
ULONG uOffsetAppMimeType;
GUID AppGuid;
// app extended attributes to add, modify, and remove
ULONG cAttrsToAdd;
ULONG uOffsetAttrsToAdd;
ULONG cAttrsToModify;
ULONG uOffsetAttrsToModify;
ULONG cAttrsToRemove;
ULONG uOffsetAttrsToRemove;
// for notification of enum-user-infos
ULONG cAttrsReturned;
ULONG uOffsetAttrsReturned;
}
LDAP_CLIENTINFO, *PLDAP_CLIENTINFO;
typedef struct tagLDAPClientInfoRes
{
ULONG uSize;
HRESULT hResult;
LDAP_CLIENTINFO lci;
}
LDAP_CLIENTINFO_RES, *PLDAP_CLIENTINFO_RES;
typedef struct tagLDAPProtocolInfo
{
ULONG uSize;
// protocol standard attributes
ULONG uOffsetName;
ULONG uPortNumber;
ULONG uOffsetMimeType;
}
LDAP_PROTINFO, *PLDAP_PROTINFO;
typedef struct tagLDAPProtInfoRes
{
ULONG uSize;
HRESULT hResult;
LDAP_PROTINFO lpi;
}
LDAP_PROTINFO_RES, *PLDAP_PROTINFO_RES;
#ifdef ENABLE_MEETING_PLACE
typedef struct tagLDAPMeetingInfo
{
ULONG uSize;
// meeting standard attributes
LONG lMeetingPlaceType;
LONG lAttendeeType;
ULONG uOffsetMeetingPlaceID;
ULONG uOffsetDescription;
ULONG uOffsetHostName;
ULONG uOffsetHostIPAddress;
// meeting extended attributes to add, modify, and remove
ULONG cAttrsToAdd;
ULONG uOffsetAttrsToAdd;
ULONG cAttrsToModify;
ULONG uOffsetAttrsToModify;
ULONG cAttrsToRemove;
ULONG uOffsetAttrsToRemove;
// for notification of enum-meeting-infos
ULONG cAttrsReturned;
ULONG uOffsetAttrsReturned;
}
LDAP_MEETINFO, *PLDAP_MEETINFO;
#endif
#ifdef ENABLE_MEETING_PLACE
typedef struct tagLDAPMeetingInfoRes
{
ULONG uSize;
HRESULT hResult;
LDAP_MEETINFO lmi;
}
LDAP_MEETINFO_RES, *PLDAP_MEETINFO_RES;
#endif
// Initialization
HRESULT UlsLdap_Initialize (
HWND hwndCallback);
HRESULT UlsLdap_Deinitialize (void);
HRESULT UlsLdap_Cancel (
ULONG uMsgID);
// Clients related
HRESULT UlsLdap_RegisterClient (
DWORD_PTR dwContext,
SERVER_INFO *pServer,
PLDAP_CLIENTINFO pCleintInfo,
PHANDLE phClient,
PLDAP_ASYNCINFO pAsyncInfo );
HRESULT UlsLdap_UnRegisterClient (
HANDLE hClient,
PLDAP_ASYNCINFO pAsyncInfo );
HRESULT UlsLdap_SetClientInfo (
HANDLE hClient,
PLDAP_CLIENTINFO pInfo,
PLDAP_ASYNCINFO pAsyncInfo );
HRESULT UlsLdap_EnumClients (
SERVER_INFO *pServer,
LPTSTR pszFilter,
PLDAP_ASYNCINFO pAsyncInfo );
HRESULT UlsLdap_ResolveClient (
SERVER_INFO *pServer,
LPTSTR pszUserName,
LPTSTR pszAppName,
LPTSTR pszProtName,
LPTSTR pszAttrNameList,
ULONG cAttrNames,
PLDAP_ASYNCINFO pAsyncInfo );
HRESULT UlsLdap_EnumClientInfos (
SERVER_INFO *pServer,
LPTSTR pszAttrNameList,
ULONG cAttrNames,
LPTSTR pszFilter,
PLDAP_ASYNCINFO pAsyncInfo );
// Protocols related
HRESULT UlsLdap_RegisterProtocol (
HANDLE hApp,
PLDAP_PROTINFO pProtInfo,
PHANDLE phProt,
PLDAP_ASYNCINFO pAsyncInfo );
HRESULT UlsLdap_UnRegisterProtocol (
HANDLE hProt,
PLDAP_ASYNCINFO pAsyncInfo );
HRESULT UlsLdap_VirtualUnRegisterProtocol (
HANDLE hProt );
HRESULT UlsLdap_SetProtocolInfo (
HANDLE hProt,
PLDAP_PROTINFO pInfo,
PLDAP_ASYNCINFO pAsyncInfo );
HRESULT UlsLdap_EnumProtocols (
SERVER_INFO *pServer,
LPTSTR pszUserName,
LPTSTR pszAppName,
PLDAP_ASYNCINFO pAsyncInfo );
HRESULT UlsLdap_ResolveProtocol (
SERVER_INFO *pServer,
LPTSTR pszUserName,
LPTSTR pszAppName,
LPTSTR pszProtName,
LPTSTR pszAnyAttrNameList,
ULONG cAttrNames,
PLDAP_ASYNCINFO pAsyncInfo );
#ifdef ENABLE_MEETING_PLACE
// Meetings related
HRESULT UlsLdap_RegisterMeeting(
DWORD dwContext,
SERVER_INFO *pServer,
PLDAP_MEETINFO pMeetInfo,
PHANDLE phMeeting,
PLDAP_ASYNCINFO pAsyncInfo );
HRESULT UlsLdap_UnRegisterMeeting(
HANDLE hMeeting,
PLDAP_ASYNCINFO pAsyncInfo );
HRESULT UlsLdap_EnumMeetingInfos(
SERVER_INFO *pServer,
LPTSTR pszAnyAttrNameList,
ULONG cAnyAttrNames,
LPTSTR pszFilter,
PLDAP_ASYNCINFO pAsyncInfo );
HRESULT UlsLdap_EnumMeetings(
SERVER_INFO *pServer,
LPTSTR pszFilter,
PLDAP_ASYNCINFO pAsyncInfo );
HRESULT UlsLdap_ResolveMeeting(
SERVER_INFO *pServer,
LPTSTR pszMeetingID,
LPTSTR pszAnyAttrNameList,
ULONG cAnyAttrNames,
PLDAP_ASYNCINFO pAsyncInfo );
HRESULT UlsLdap_SetMeetingInfo(
SERVER_INFO *pServer,
LPTSTR pszMeetingID,
PLDAP_MEETINFO pMeetInfo,
PLDAP_ASYNCINFO pAsyncInfo );
HRESULT UlsLdap_AddAttendee(
SERVER_INFO *pServer,
LPTSTR pszMeetingID,
ULONG cAttendees,
LPTSTR pszAttendeeID,
PLDAP_ASYNCINFO pAsyncInfo );
HRESULT UlsLdap_RemoveAttendee(
SERVER_INFO *pServer,
LPTSTR pszMeetingID,
ULONG cAttendees,
LPTSTR pszAttendeeID,
PLDAP_ASYNCINFO pAsyncInfo );
HRESULT UlsLdap_EnumAttendees(
SERVER_INFO *pServer,
LPTSTR pszMeetingID,
LPTSTR pszFilter,
PLDAP_ASYNCINFO pAsyncInfo );
#endif // ENABLE_MEETING_PLACE
const TCHAR *UlsLdap_GetStdAttrNameString (
ILS_STD_ATTR_NAME StdName );
const TCHAR *UlsLdap_GetExtAttrNamePrefix ( VOID );
#include <poppack.h>
#endif // _ILS_LDAP_H_