summaryrefslogtreecommitdiff
path: root/lib/ShadowCopy/shadow.h
blob: ea113dae604938893fc60e7bca77173d09b2c011 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
// **************************************************************************
// * This file is part of the FreeFileSync project. It is distributed under *
// * GNU General Public License: http://www.gnu.org/licenses/gpl.html       *
// * Copyright (C) ZenJu (zhnmju123 AT gmx DOT de) - All Rights Reserved    *
// **************************************************************************

#ifndef SHADOWCOPY_H
#define SHADOWCOPY_H

#ifdef SHADOWDLL_EXPORTS
#define SHADOWDLL_API extern "C" __declspec(dllexport)
#else
#define SHADOWDLL_API extern "C" __declspec(dllimport)
#endif

#include <zen/build_info.h>
#include <zen/win_ver.h>


class IVssBackupComponents;

namespace shadow
{
/*--------------
  |declarations|
  --------------*/

//COM needs to be initialized before calling any of these functions! CoInitializeEx/CoUninitialize
struct ShadowData;
typedef ShadowData* ShadowHandle;

//volumeName *must* end with "\"
SHADOWDLL_API
ShadowHandle createShadowCopy(const wchar_t* volumeName,      // in  Returns nullptr on failure!
                              wchar_t*		 errorMessage,    // out
                              unsigned int	 errorBufferLen); // in

//don't forget to release the backupHandle after shadow copy is not needed anymore!
SHADOWDLL_API
void releaseShadowCopy(ShadowHandle handle);

SHADOWDLL_API
void getShadowVolume(ShadowHandle handle, //shadowVolName does *not* end with "\"
                     wchar_t*	  buffer,
                     unsigned int bufferLen);

//##########################################################################################


/*----------
  |typedefs|
  ----------*/
typedef ShadowHandle (*CreateShadowCopyFct)(const wchar_t* volumeName,
                                            wchar_t*	    errorMessage,
                                            unsigned int   errorBufferLen);

typedef void (*ReleaseShadowCopyFct)(ShadowHandle handle);

typedef void (*GetShadowVolumeFct)(ShadowHandle handle,
                                   wchar_t*	   buffer,
                                   unsigned int bufferLen);


/*--------------
  |symbol names|
  --------------*/
//(use const pointers to ensure internal linkage)
const char createShadowCopyFctName [] = "createShadowCopy";
const char releaseShadowCopyFctName[] = "releaseShadowCopy";
const char getShadowVolumeFctName  [] = "getShadowVolume";

/*---------------
  |library names|
  ---------------*/

inline
const wchar_t* getDllName()
{
    // distinguish a bunch of VSS builds: we use XP, Server 2003 and Server 2008 R2 implementations...
    // VSS version and compatibility overview: http://msdn.microsoft.com/en-us/library/aa384627(VS.85).aspx

    if (zen::win7OrLater()) //Windows Server 2008 R2 or Windows 7
        return zen::is64BitBuild ?
               L"Shadow_Windows7_x64.dll" :
               L"Shadow_Windows7_Win32.dll";
    //else if (vistaOrLater()) -> skip Windows Server 2008 and Windows Vista
    //			   ;
    else if (zen::winServer2003orLater()) //Windows Server 2003 and Windows Server 2003 R2
        return zen::is64BitBuild ?
               L"Shadow_Server2003_x64.dll" :
               L"Shadow_Server2003_Win32.dll";
    else //Windows XP
        return zen::is64BitBuild ?
               L"Shadow_XP_x64.dll" :
               L"Shadow_XP_Win32.dll";
}
}

#endif //SHADOWCOPY_H
bgstack15