334 lines
9.5 KiB
C++
334 lines
9.5 KiB
C++
|
//+----------------------------------------------------------------------------
|
||
|
|
//
|
||
|
|
// Copyright (C) 1995, Microsoft Corporation
|
||
|
|
//
|
||
|
|
// File: cdfsvol.hxx
|
||
|
|
//
|
||
|
|
// Contents: Class to abstract a Dfs Volume object and all the
|
||
|
|
// administration operations that can be performed on a
|
||
|
|
// volume object.
|
||
|
|
//
|
||
|
|
// Classes: CDfsVolume
|
||
|
|
//
|
||
|
|
// Functions:
|
||
|
|
//
|
||
|
|
// History: 05/10/93 Sudk Created.
|
||
|
|
// 12/19/95 Milans Ported to NT.
|
||
|
|
//
|
||
|
|
//-----------------------------------------------------------------------------
|
||
|
|
|
||
|
|
#ifndef _CDFSVOL_HXX_
|
||
|
|
#define _CDFSVOL_HXX_
|
||
|
|
|
||
|
|
#include "svclist.hxx"
|
||
|
|
#include "crecover.hxx"
|
||
|
|
#include "recon.hxx"
|
||
|
|
|
||
|
|
#define VolumeOffLine() ((_State == DFS_VOLUME_STATE_OFFLINE) || \
|
||
|
|
(_Deleted == TRUE))
|
||
|
|
|
||
|
|
#define VolumeDeleted() (_Deleted == TRUE)
|
||
|
|
|
||
|
|
extern const GUID CLSID_CDfsVolume;
|
||
|
|
|
||
|
|
//+-------------------------------------------------------------------------
|
||
|
|
//
|
||
|
|
// Class: CDfsVolume
|
||
|
|
//
|
||
|
|
// Synopsis: DfsVol runtime class - This is the class that represents
|
||
|
|
// volumes in the Dfs namespace. This is the primary way to
|
||
|
|
// manipulate volumes and to perform administrative operations on
|
||
|
|
// them.
|
||
|
|
//
|
||
|
|
// For SUR, this class has been completely de-OLEized. However,
|
||
|
|
// most of the methods are modeled after OLE methods of standard
|
||
|
|
// interfaces.
|
||
|
|
//
|
||
|
|
// History: 05/10/93 SudK Created.
|
||
|
|
// 12/19/95 Milans Converted to NT.
|
||
|
|
//
|
||
|
|
//--------------------------------------------------------------------------
|
||
|
|
|
||
|
|
class CDfsVolume : public CReference
|
||
|
|
{
|
||
|
|
|
||
|
|
friend DWORD InitializeVolumeObject(
|
||
|
|
PWSTR pwszVolName,
|
||
|
|
BOOLEAN bInitVol,
|
||
|
|
BOOLEAN SyncRemoteServerName);
|
||
|
|
|
||
|
|
friend NTSTATUS DfsManagerHandleKnowledgeInconsistency(
|
||
|
|
PBYTE Buffer,
|
||
|
|
ULONG cbMessage);
|
||
|
|
|
||
|
|
public:
|
||
|
|
|
||
|
|
CDfsVolume(void);
|
||
|
|
|
||
|
|
~CDfsVolume();
|
||
|
|
|
||
|
|
//
|
||
|
|
// IPersist Methods
|
||
|
|
//
|
||
|
|
|
||
|
|
DWORD GetClassID(LPCLSID lpClassID);
|
||
|
|
|
||
|
|
//
|
||
|
|
// IPersistStorage Methods
|
||
|
|
//
|
||
|
|
|
||
|
|
DWORD InitNew(CStorage *pStg);
|
||
|
|
|
||
|
|
DWORD Load(CStorage *pStg);
|
||
|
|
|
||
|
|
DWORD Save(CStorage *pStgSave, BOOL fSameAsLoad);
|
||
|
|
|
||
|
|
//
|
||
|
|
// IPersistFile Methods
|
||
|
|
//
|
||
|
|
|
||
|
|
DWORD Load(LPCTSTR lpszFileName, DWORD grfMode);
|
||
|
|
|
||
|
|
DWORD Save(LPCTSTR lpszFileName, BOOL fRemember);
|
||
|
|
|
||
|
|
//
|
||
|
|
// IDfsVolume Methods.
|
||
|
|
//
|
||
|
|
|
||
|
|
DWORD AddReplica(
|
||
|
|
PDFS_REPLICA_INFO pReplicaInfo,
|
||
|
|
ULONG fCreateOptions);
|
||
|
|
|
||
|
|
DWORD RemoveReplica(
|
||
|
|
PDFS_REPLICA_INFO pReplicaInfo,
|
||
|
|
ULONG fDeleteOptions);
|
||
|
|
|
||
|
|
DWORD Delete(
|
||
|
|
ULONG fDeleteOptions);
|
||
|
|
|
||
|
|
DWORD SetComment(
|
||
|
|
LPWSTR pwszComment);
|
||
|
|
|
||
|
|
DWORD GetNetInfo(
|
||
|
|
DWORD Level,
|
||
|
|
LPDFS_INFO_3 pInfo,
|
||
|
|
LPDWORD pcbInfo);
|
||
|
|
|
||
|
|
DWORD Move(
|
||
|
|
LPWSTR pwszNewPrefix);
|
||
|
|
|
||
|
|
DWORD Rename(
|
||
|
|
LPWSTR oldPrefix,
|
||
|
|
LPWSTR newPrefix);
|
||
|
|
|
||
|
|
DWORD CreateChild(
|
||
|
|
LPWSTR pwszPrefix,
|
||
|
|
ULONG ulVolType,
|
||
|
|
PDFS_REPLICA_INFO pReplicaInfo,
|
||
|
|
LPWSTR pwszComment,
|
||
|
|
ULONG fCreateOptions);
|
||
|
|
|
||
|
|
DWORD GetObjectID(
|
||
|
|
LPGUID idVolume);
|
||
|
|
|
||
|
|
//
|
||
|
|
// The following methods should probably be in a private interface??
|
||
|
|
//
|
||
|
|
|
||
|
|
DWORD CreateObject(
|
||
|
|
LPWSTR pwszVolObjName,
|
||
|
|
LPWSTR pwszPrefix,
|
||
|
|
ULONG ulVolType,
|
||
|
|
PDFS_REPLICA_INFO pReplicaInfo,
|
||
|
|
LPWSTR pwszComment,
|
||
|
|
GUID *pUid);
|
||
|
|
|
||
|
|
DWORD GetReplicaSetID(
|
||
|
|
GUID *guidRsid);
|
||
|
|
|
||
|
|
DWORD SetReplicaSetID(
|
||
|
|
GUID *guidRsid);
|
||
|
|
|
||
|
|
DWORD AddReplicaToObj(
|
||
|
|
PDFS_REPLICA_INFO pReplicaInfo);
|
||
|
|
|
||
|
|
DWORD RemoveReplicaFromObj(
|
||
|
|
LPWSTR pwszMachineName);
|
||
|
|
|
||
|
|
DWORD ChangeStorageID(
|
||
|
|
LPWSTR pwszMachineName,
|
||
|
|
LPWSTR pwszNetStorageId);
|
||
|
|
|
||
|
|
DWORD SetReplicaState(
|
||
|
|
LPWSTR pwszMachineName,
|
||
|
|
LPWSTR pwszShareName,
|
||
|
|
ULONG fState);
|
||
|
|
|
||
|
|
DWORD SetVolumeState(
|
||
|
|
ULONG fState);
|
||
|
|
|
||
|
|
DWORD SetVolumeTimeout(
|
||
|
|
ULONG Timeout);
|
||
|
|
//
|
||
|
|
// IDfsUpdate overrides
|
||
|
|
//
|
||
|
|
|
||
|
|
DWORD ModifyEntryPath(
|
||
|
|
LPWSTR oldPrefix,
|
||
|
|
LPWSTR newPrefix );
|
||
|
|
|
||
|
|
//
|
||
|
|
// Not part of any interface.
|
||
|
|
//
|
||
|
|
|
||
|
|
DWORD InitializePkt(HANDLE PktHandle);
|
||
|
|
|
||
|
|
DWORD UpdatePktEntry(HANDLE PktHandle);
|
||
|
|
|
||
|
|
DWORD FixServiceKnowledge(
|
||
|
|
LPWSTR PrincipalName);
|
||
|
|
|
||
|
|
DWORD CreateChildX(
|
||
|
|
LPWSTR childName,
|
||
|
|
LPWSTR pwszPrefix,
|
||
|
|
ULONG fVolType,
|
||
|
|
LPWSTR pwszComment,
|
||
|
|
CDfsVolume **ppChild);
|
||
|
|
|
||
|
|
BOOLEAN IsValidService(
|
||
|
|
LPWSTR wszServer);
|
||
|
|
|
||
|
|
DWORD SyncWithRemoteServerNameInDs(void);
|
||
|
|
|
||
|
|
|
||
|
|
private:
|
||
|
|
|
||
|
|
CStorage *_pStorage;
|
||
|
|
PWSTR _pwzFileName;
|
||
|
|
PWSTR _pwszParentName;
|
||
|
|
DWORD _dwRotRegistration;
|
||
|
|
DFS_PKT_ENTRY_ID _peid;
|
||
|
|
PWSTR _pwszComment;
|
||
|
|
ULONG _EntryType;
|
||
|
|
ULONG _State;
|
||
|
|
ULONG _Timeout;
|
||
|
|
ULONG _RecoveryState;
|
||
|
|
CDfsService *_pRecoverySvc;
|
||
|
|
ULONG _Deleted;
|
||
|
|
ULONG _Version;
|
||
|
|
CRecover _Recover;
|
||
|
|
CDfsServiceList _DfsSvcList;
|
||
|
|
FILETIME _ftEntryPath;
|
||
|
|
FILETIME _ftState;
|
||
|
|
FILETIME _ftComment;
|
||
|
|
WCHAR _FileNameBuffer[MAX_PATH+1];
|
||
|
|
WCHAR _ParentNameBuffer[MAX_PATH+1];
|
||
|
|
WCHAR _EntryPathBuffer[MAX_PATH+1];
|
||
|
|
WCHAR _ShortPathBuffer[MAX_PATH+1];
|
||
|
|
|
||
|
|
DWORD CreateChildPartition(
|
||
|
|
PWCHAR Name,
|
||
|
|
ULONG Type,
|
||
|
|
PWCHAR EntryPath,
|
||
|
|
PWCHAR pwszComment,
|
||
|
|
GUID *pUid,
|
||
|
|
PDFS_REPLICA_INFO pReplInfo,
|
||
|
|
CDfsVolume **NewIDfsVol);
|
||
|
|
|
||
|
|
BOOL IsValidChildName(
|
||
|
|
PWCHAR pwszChildPrefix,
|
||
|
|
GUID *pidChild);
|
||
|
|
|
||
|
|
BOOL NotLeafVolume();
|
||
|
|
|
||
|
|
DWORD GetParent(
|
||
|
|
CDfsVolume **parent);
|
||
|
|
|
||
|
|
DWORD GetVersion(
|
||
|
|
ULONG *pVersion);
|
||
|
|
|
||
|
|
DWORD SetVersion(
|
||
|
|
BOOL bCreate);
|
||
|
|
|
||
|
|
DWORD GetIdProps(
|
||
|
|
ULONG *pdwType,
|
||
|
|
PWCHAR *ppwszEntryPath,
|
||
|
|
PWCHAR *ppwszShortPath,
|
||
|
|
PWCHAR *ppwszComment,
|
||
|
|
GUID *pGuid,
|
||
|
|
ULONG *pdwVolumeState,
|
||
|
|
ULONG *pdwTimeout,
|
||
|
|
FILETIME *pftPathTime,
|
||
|
|
FILETIME *pftStateTime,
|
||
|
|
FILETIME *pftCommentTime);
|
||
|
|
|
||
|
|
DWORD SetIdProps(
|
||
|
|
ULONG Type,
|
||
|
|
ULONG State,
|
||
|
|
PWCHAR pwszPrefix,
|
||
|
|
PWCHAR pwszShortPath,
|
||
|
|
GUID &Guid,
|
||
|
|
PWCHAR pwszComment,
|
||
|
|
ULONG Timeout,
|
||
|
|
FILETIME ftPrefix,
|
||
|
|
FILETIME ftState,
|
||
|
|
FILETIME ftComment,
|
||
|
|
BOOLEAN bCreate);
|
||
|
|
|
||
|
|
DWORD DeleteObject();
|
||
|
|
|
||
|
|
DWORD DeletePktEntry(
|
||
|
|
PDFS_PKT_ENTRY_ID peid);
|
||
|
|
|
||
|
|
DWORD CreateSubordinatePktEntry(
|
||
|
|
HANDLE pktHandle,
|
||
|
|
PDFS_PKT_ENTRY_ID peid,
|
||
|
|
BOOLEAN withService);
|
||
|
|
|
||
|
|
DWORD SetParentPath(void);
|
||
|
|
|
||
|
|
DWORD GetDfsVolumeFromStg(
|
||
|
|
DFSMSTATDIR *rgelt,
|
||
|
|
CDfsVolume **pDfsVol);
|
||
|
|
|
||
|
|
DWORD RecoverFromFailure(void);
|
||
|
|
|
||
|
|
DWORD RecoverFromCreation(
|
||
|
|
ULONG OperStage);
|
||
|
|
|
||
|
|
DWORD RecoverFromAddService(
|
||
|
|
ULONG OperStage);
|
||
|
|
|
||
|
|
DWORD RecoverFromRemoveService(
|
||
|
|
ULONG OperStage);
|
||
|
|
|
||
|
|
DWORD RecoverFromDelete(
|
||
|
|
ULONG OperStage);
|
||
|
|
|
||
|
|
DWORD RecoverFromMove(
|
||
|
|
ULONG OperStage);
|
||
|
|
|
||
|
|
DWORD ModifyLocalEntryPath(
|
||
|
|
PWCHAR newEntryPath,
|
||
|
|
FILETIME ftEntryPath,
|
||
|
|
BOOL fUpdatePkt);
|
||
|
|
|
||
|
|
DWORD ReconcileIdProps(
|
||
|
|
PDFS_ID_PROPS pIdProps );
|
||
|
|
|
||
|
|
DWORD ReconcileSvcList(
|
||
|
|
const ULONG cSvcs,
|
||
|
|
CDfsService *pSvcList );
|
||
|
|
|
||
|
|
DWORD UpgradeObject();
|
||
|
|
|
||
|
|
DWORD SaveShortName();
|
||
|
|
|
||
|
|
DWORD LoadNoRegister(
|
||
|
|
LPCTSTR lpszFileName,
|
||
|
|
DWORD grfMode);
|
||
|
|
|
||
|
|
};
|
||
|
|
|
||
|
|
#endif
|