267 lines
7.7 KiB
C++
267 lines
7.7 KiB
C++
|
/**********************************************************************/
|
||
|
|
/** Microsoft LAN Manager **/
|
||
|
|
/** Copyright(c) Microsoft Corp., 1991 **/
|
||
|
|
/**********************************************************************/
|
||
|
|
|
||
|
|
/*
|
||
|
|
lmomemb.hxx
|
||
|
|
MEMBERSHIP_LMOBJ class declaration
|
||
|
|
|
||
|
|
|
||
|
|
FILE HISTORY:
|
||
|
|
rustanl 20-Aug-1991 Created
|
||
|
|
jonn 03-Sep-1991 Added USER_MEMB::Query/SetName
|
||
|
|
terryk 07-Oct-1991 type change for NT
|
||
|
|
jonn 11-Oct-1991 Added GROUP_MEMB::SetName
|
||
|
|
jonn 14-Oct-1991 Added GROUP_MEMB::I_ChangeToNew etc.
|
||
|
|
terryk 17-Oct-1991 Remove 2 parameters from CallAPI
|
||
|
|
function
|
||
|
|
jonn 07-Jun-1992 Added _slAddedNames to MEMBERSHIP_LM_OBJ
|
||
|
|
|
||
|
|
*/
|
||
|
|
|
||
|
|
|
||
|
|
#ifndef _LMOMEMB_HXX_
|
||
|
|
#define _LMOMEMB_HXX_
|
||
|
|
|
||
|
|
|
||
|
|
#include "lmobj.hxx"
|
||
|
|
#include "lmoloc.hxx"
|
||
|
|
#include "lmoenum.hxx"
|
||
|
|
#include "strlst.hxx"
|
||
|
|
|
||
|
|
|
||
|
|
/*************************************************************************
|
||
|
|
|
||
|
|
NAME: ENUM_CALLER_LM_OBJ
|
||
|
|
|
||
|
|
SYNOPSIS: Class providing the nice read/write/new features
|
||
|
|
of the lmobj hierarchy, and the enumeration capabilities
|
||
|
|
of the lmoenum hierarchy.
|
||
|
|
|
||
|
|
INTERFACE: ENUM_CALLER_LM_OBJ() - constructor
|
||
|
|
|
||
|
|
PARENT: LOC_LM_OBJ, ENUM_CALLER
|
||
|
|
|
||
|
|
HISTORY:
|
||
|
|
rustanl 21-Aug-1991 Created
|
||
|
|
|
||
|
|
**************************************************************************/
|
||
|
|
|
||
|
|
DLL_CLASS ENUM_CALLER_LM_OBJ : public LOC_LM_OBJ, public ENUM_CALLER
|
||
|
|
{
|
||
|
|
private:
|
||
|
|
// Virtuals from ENUM_CALLER class
|
||
|
|
virtual BYTE * EC_QueryBufferPtr() const;
|
||
|
|
virtual APIERR EC_SetBufferPtr( BYTE * pBuffer );
|
||
|
|
virtual UINT EC_QueryBufferSize() const;
|
||
|
|
virtual APIERR EC_ResizeBuffer( UINT cNewRequestedSize );
|
||
|
|
|
||
|
|
protected:
|
||
|
|
// Rooted in NEW_LM_OBJ
|
||
|
|
|
||
|
|
virtual APIERR W_CreateNew();
|
||
|
|
|
||
|
|
// Rooted in ENUM_CALLER
|
||
|
|
|
||
|
|
virtual APIERR CallAPI( BYTE ** pBuffer,
|
||
|
|
UINT * pcEntriesRead) = 0;
|
||
|
|
|
||
|
|
virtual UINT QueryItemSize() const = 0;
|
||
|
|
|
||
|
|
APIERR W_CloneFrom( const ENUM_CALLER_LM_OBJ & eclmobj );
|
||
|
|
|
||
|
|
public:
|
||
|
|
ENUM_CALLER_LM_OBJ( const LOCATION & loc );
|
||
|
|
|
||
|
|
}; // class ENUM_CALLER_LM_OBJ
|
||
|
|
|
||
|
|
|
||
|
|
/*************************************************************************
|
||
|
|
|
||
|
|
NAME: MEMBERSHIP_LM_OBJ
|
||
|
|
|
||
|
|
SYNOPSIS: Group/user membership lmobj class
|
||
|
|
|
||
|
|
INTERFACE: MEMBERSHIP_LM_OBJ() - constructor
|
||
|
|
|
||
|
|
QueryAssocName - returns name of an associated item
|
||
|
|
FindAssocName - finds an associated name
|
||
|
|
AddAssocName - adds an associated name
|
||
|
|
DeleteAssocName - deletes an associated name
|
||
|
|
|
||
|
|
PARENT: ENUM_CALLER_LM_OBJ
|
||
|
|
|
||
|
|
NOTES: This class is specialized to handle the NetGroupGetUsers
|
||
|
|
and NetUserGetGropus (and the corresponding Set methods).
|
||
|
|
It assumes a lot of things about these structures and
|
||
|
|
APIs. Hence, this is not a generic membership/association
|
||
|
|
lmobj class. This is not bad because of the following
|
||
|
|
reasons:
|
||
|
|
0. The ENUM_CALLER_LM_OBJ class exists to provide
|
||
|
|
clients with lmobj classes that call enumeration
|
||
|
|
type Net APIs.
|
||
|
|
1. If groups and users will not look as identical
|
||
|
|
to each other as they do today (8/21/91), the
|
||
|
|
'virtual' keyword can be added in front of
|
||
|
|
appropriate methods, and the subclasses can
|
||
|
|
take appropriate actions.
|
||
|
|
|
||
|
|
See also note in MEMBERSHIP_LM_OBJ::QueryItemSize method
|
||
|
|
header.
|
||
|
|
|
||
|
|
The USER_MEMB subclass revolves around a user and its
|
||
|
|
associated groups. The GROUP_MEMB subclass revolves
|
||
|
|
around a group and its associated users. The term
|
||
|
|
"associated name" will be used in methods and comments.
|
||
|
|
|
||
|
|
HISTORY:
|
||
|
|
rustanl 21-Aug-1991 Created
|
||
|
|
jonn 07-Jun-1992 Added _slAddedNames to MEMBERSHIP_LM_OBJ
|
||
|
|
|
||
|
|
**************************************************************************/
|
||
|
|
|
||
|
|
DLL_CLASS MEMBERSHIP_LM_OBJ : public ENUM_CALLER_LM_OBJ
|
||
|
|
{
|
||
|
|
private:
|
||
|
|
UINT _uAssocNameType;
|
||
|
|
|
||
|
|
#ifdef WIN32
|
||
|
|
STRLIST _slAddedNames;
|
||
|
|
#endif // WIN32
|
||
|
|
|
||
|
|
protected:
|
||
|
|
// Replaced from ENUM_CALLER
|
||
|
|
|
||
|
|
virtual APIERR CallAPI( BYTE ** pBuffer,
|
||
|
|
UINT * pcEntriesRead) = 0;
|
||
|
|
|
||
|
|
virtual UINT QueryItemSize() const;
|
||
|
|
|
||
|
|
// Replaced from NEW_LM_OBJ
|
||
|
|
|
||
|
|
virtual APIERR I_GetInfo();
|
||
|
|
virtual APIERR I_WriteNew();
|
||
|
|
|
||
|
|
APIERR W_CloneFrom( const MEMBERSHIP_LM_OBJ & memblmobj );
|
||
|
|
|
||
|
|
public:
|
||
|
|
MEMBERSHIP_LM_OBJ( const LOCATION & loc,
|
||
|
|
UINT uAssocNameType );
|
||
|
|
|
||
|
|
const TCHAR * QueryAssocName( UINT i ) const;
|
||
|
|
BOOL FindAssocName( const TCHAR * pszName, UINT * pi );
|
||
|
|
APIERR AddAssocName( const TCHAR * pszName );
|
||
|
|
APIERR DeleteAssocName( const TCHAR * pszName );
|
||
|
|
APIERR DeleteAssocName( UINT i );
|
||
|
|
|
||
|
|
}; // class MEMBERSHIP_LM_OBJ
|
||
|
|
|
||
|
|
|
||
|
|
/*************************************************************************
|
||
|
|
|
||
|
|
NAME: USER_MEMB
|
||
|
|
|
||
|
|
SYNOPSIS: User's group membership lmobj class
|
||
|
|
|
||
|
|
INTERFACE: USER_MEMB() - constructor
|
||
|
|
~USER_MEMB() - destructor
|
||
|
|
|
||
|
|
CloneFrom() - clones a USER_ENUM object
|
||
|
|
|
||
|
|
QueryName
|
||
|
|
Returns the user's account name.
|
||
|
|
|
||
|
|
SetName
|
||
|
|
Sets the user's account name.
|
||
|
|
|
||
|
|
PARENT: MEMBERSHIP_LM_OBJ
|
||
|
|
|
||
|
|
HISTORY:
|
||
|
|
rustanl 21-Aug-1991 Created
|
||
|
|
jonn 05-Sep-1991 Added Query/SetName
|
||
|
|
|
||
|
|
**************************************************************************/
|
||
|
|
|
||
|
|
DLL_CLASS USER_MEMB : public MEMBERSHIP_LM_OBJ
|
||
|
|
{
|
||
|
|
private:
|
||
|
|
DECL_CLASS_NLS_STR( _nlsUser, UNLEN ); // account name, may be ""
|
||
|
|
|
||
|
|
protected:
|
||
|
|
// Replaced from NEW_LM_OBJ
|
||
|
|
|
||
|
|
virtual APIERR I_CreateNew();
|
||
|
|
virtual APIERR W_CreateNew();
|
||
|
|
virtual APIERR I_ChangeToNew();
|
||
|
|
virtual APIERR I_WriteInfo();
|
||
|
|
|
||
|
|
// Replaced from MEMBERSHIP_LM_OBJ
|
||
|
|
|
||
|
|
virtual APIERR CallAPI( BYTE ** pBuffer,
|
||
|
|
UINT * pcEntriesRead);
|
||
|
|
|
||
|
|
public:
|
||
|
|
USER_MEMB( const LOCATION & loc,
|
||
|
|
const TCHAR * pszUser );
|
||
|
|
~USER_MEMB();
|
||
|
|
|
||
|
|
APIERR CloneFrom( const USER_MEMB & umemb );
|
||
|
|
|
||
|
|
const TCHAR *QueryName() const;
|
||
|
|
APIERR SetName( const TCHAR *pszAccount );
|
||
|
|
|
||
|
|
}; // class USER_MEMB
|
||
|
|
|
||
|
|
|
||
|
|
/*************************************************************************
|
||
|
|
|
||
|
|
NAME: GROUP_MEMB
|
||
|
|
|
||
|
|
SYNOPSIS: Group's user members lmobj class
|
||
|
|
|
||
|
|
INTERFACE: GROUP_MEMB() - constructor
|
||
|
|
~GROUP_MEMB() - destructor
|
||
|
|
|
||
|
|
CloneFrom() - clones a GROUP_ENUM object
|
||
|
|
|
||
|
|
PARENT: MEMBERSHIP_LM_OBJ
|
||
|
|
|
||
|
|
HISTORY:
|
||
|
|
rustanl 21-Aug-1991 Created
|
||
|
|
|
||
|
|
**************************************************************************/
|
||
|
|
|
||
|
|
DLL_CLASS GROUP_MEMB : public MEMBERSHIP_LM_OBJ
|
||
|
|
{
|
||
|
|
private:
|
||
|
|
DECL_CLASS_NLS_STR( _nlsGroup, GNLEN ); // account name, may be ""
|
||
|
|
|
||
|
|
protected:
|
||
|
|
// Replaced from MEMBERSHIP_LM_OBJ
|
||
|
|
|
||
|
|
virtual APIERR CallAPI( BYTE ** pBuffer,
|
||
|
|
UINT * pcEntriesRead);
|
||
|
|
|
||
|
|
// Replaced from NEW_LM_OBJ
|
||
|
|
|
||
|
|
virtual APIERR I_WriteInfo();
|
||
|
|
virtual APIERR I_CreateNew();
|
||
|
|
virtual APIERR W_CreateNew();
|
||
|
|
virtual APIERR I_ChangeToNew();
|
||
|
|
|
||
|
|
public:
|
||
|
|
GROUP_MEMB( const LOCATION & loc,
|
||
|
|
const TCHAR * pszGroup );
|
||
|
|
~GROUP_MEMB();
|
||
|
|
|
||
|
|
APIERR CloneFrom( const GROUP_MEMB & gmemb );
|
||
|
|
|
||
|
|
const TCHAR *QueryName() const;
|
||
|
|
APIERR SetName( const TCHAR *pszAccount );
|
||
|
|
|
||
|
|
}; // class GROUP_MEMB
|
||
|
|
|
||
|
|
|
||
|
|
#endif // _LMOMEMB_HXX_
|