msoffice_crypt 0.1.6

msoffice-crypt bindings for the Rust programming language.
Documentation 
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
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129

#pragma once
#include <stdlib.h>
/**
	@file
	@brief MS Office Crypt tool dll
	@author herumi
	Copyright (C) 2016 Cybozu Labs, Inc., all rights reserved.
*/

#ifdef _MSC_VER
	#ifndef MSOC_DONT_AUTO_LINK
		#pragma comment(lib, "msoc.lib")
	#endif
	#ifdef _WIN64
		#define MSOC_DLL_EXPORT

	#else
		#define MSOC_DLL_EXPORT __stdcall

	#endif
#else
	#define MSOC_DLL_EXPORT

#endif

#ifdef __cplusplus
extern "C" {
#endif

#define MSOC_NOERR 0

#define MSOC_ERR_NOT_SUPPORT (-1)

#define MSOC_ERR_ALREADY_ENCRYPTED (-2)

#define MSOC_ERR_ALREADY_DECRYPTED (-3)

#define MSOC_ERR_BAD_PASSWORD (-4)

#define MSOC_ERR_BAD_PARAMETER (-5)

#define MSOC_ERR_SMALL_MAX_SIZE (-6)

#define MSOC_ERR_NO_MEMORY (-7)

#define MSOC_ERR_EXCEPTION (-8)

#define MSOC_ERR_TOO_LARGE_FILE (-9)

#define MSOC_ERR_INFILE_IS_EMPTY (-10)

#define MSOC_ERR_OUTFILE_IS_EMPTY (-11)

#define MSOC_ERR_PASS_IS_EMPTY (-12)


const char * MSOC_DLL_EXPORT MSOC_getErrMessage(int err);

typedef struct msoc_opt msoc_opt;

#ifdef _MSC_VER
/*
	encrypt inFile and make outFile with pass(UTF-16 version)
	@param outFile [in] encrypted MS Office file
	@param inFile [in] plain MS Office file
	@param pass [in] password
	@param opt [inout] option (NULL is permitted)
	use spinCount, secretKey of opt if set
*/
int MSOC_DLL_EXPORT MSOC_encrypt(const wchar_t *outFile, const wchar_t *inFile, const wchar_t *pass, const msoc_opt *opt);
/*
	decrypt inFile and make outFile with pass(UTF-16 version)
	@param outFile [in] plain MS Office file (NULL is permitted)
	@param inFile [in] encrypted MS Office file
	@param pass [in] password (NULL is permitted)
	@param opt [inout] option (NULL is permitted)

	secretKey of opt is used if pass is NULL
	opt is set by the value of inFile if opt is not NULL
*/
int MSOC_DLL_EXPORT MSOC_decrypt(const wchar_t *outFile, const wchar_t *inFile, const wchar_t *pass, msoc_opt *opt);
#endif
/*
	encrypt inFile and make outFile with pass(ASCII version : not UTF-8)
	@param outFile [in] encrypted MS Office file
	@param inFile [in] plain MS Office file
	@param pass [in] password
	@param opt [inout] option (NULL is permitted)
	use spinCount, secretKey of opt if set
*/
int MSOC_DLL_EXPORT MSOC_encryptA(const char *outFile, const char *inFile, const char *pass, const msoc_opt *opt);
/*
	decrypt inFile and make outFile with pass(ASCII version : not UTF-8)
	@param outFile [in] plain MS Office file (NULL is permitted)
	@param inFile [in] encrypted MS Office file
	@param pass [in] password (NULL is permitted)
	@param opt [inout] option (NULL is permitted)

	secretKey of opt is used if pass is NULL
	opt is set by the value of inFile if opt is not NULL
*/
int MSOC_DLL_EXPORT MSOC_decryptA(const char *outFile, const char *inFile, const char *pass, msoc_opt *opt);

/*
	optType of msoc_opt
*/
#define MSOC_OPT_TYPE_SPIN_COUNT 1 // spinCount(int)

#define MSOC_OPT_TYPE_SECRET_KEY 2 // secretKey(hex ascii string) (eg. 0123ab)


/*
	create default msoc_opt
	spinCount = 100000
	secretKey = "" (auto generated)
	return pointer to msoc_opt
	err if NULL
*/
msoc_opt * MSOC_DLL_EXPORT MSOC_createOpt(void);
/*
	destroy msoc_opt
*/
void MSOC_DLL_EXPORT MSOC_destroyOpt(msoc_opt *msoc);

/*
	get int value of optType of opt);
	@param value [out] return value
*/
int MSOC_DLL_EXPORT MSOC_getInt(int *value, const msoc_opt *opt, int optType);
/*
	set int value of optType of opt
*/
int MSOC_DLL_EXPORT MSOC_setInt(msoc_opt *opt, int optType, int value);
/*
	get string value of optType of opt
	@param str [out] return value
	@param maxSize [in] buffer size of str including '\0'
*/
int MSOC_DLL_EXPORT MSOC_getStr(char *str, size_t maxSize, const msoc_opt *opt, int optType);
/*
	set string value of optType of opt
*/
int MSOC_DLL_EXPORT MSOC_setStr(msoc_opt *opt, int optType, const char *str);

#ifdef __cplusplus
}
#endif