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
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
|
#pragma once
// Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information.
#ifdef __cplusplus
extern "C" {
#endif
#define ReleaseFile(h) if (INVALID_HANDLE_VALUE != h) { ::CloseHandle(h); h = INVALID_HANDLE_VALUE; }
#define ReleaseFileHandle(h) if (INVALID_HANDLE_VALUE != h) { ::CloseHandle(h); h = INVALID_HANDLE_VALUE; }
#define ReleaseFileFindHandle(h) if (INVALID_HANDLE_VALUE != h) { ::FindClose(h); h = INVALID_HANDLE_VALUE; }
#define FILEMAKEVERSION(major, minor, build, revision) static_cast<DWORD64>((static_cast<DWORD64>(major & 0xFFFF) << 48) \
| (static_cast<DWORD64>(minor & 0xFFFF) << 32) \
| (static_cast<DWORD64>(build & 0xFFFF) << 16) \
| (static_cast<DWORD64>(revision & 0xFFFF)))
typedef enum FILE_ARCHITECTURE
{
FILE_ARCHITECTURE_UNKNOWN,
FILE_ARCHITECTURE_X86,
FILE_ARCHITECTURE_X64,
FILE_ARCHITECTURE_IA64,
} FILE_ARCHITECTURE;
typedef enum FILE_ENCODING
{
FILE_ENCODING_UNSPECIFIED = 0,
// TODO: distinguish between non-BOM utf-8 and ANSI in the future?
FILE_ENCODING_UTF8,
FILE_ENCODING_UTF8_WITH_BOM,
FILE_ENCODING_UTF16,
FILE_ENCODING_UTF16_WITH_BOM,
} FILE_ENCODING;
HRESULT DAPI FileStripExtension(
__in_z LPCWSTR wzFileName,
__out LPWSTR *ppwzFileNameNoExtension
);
HRESULT DAPI FileChangeExtension(
__in_z LPCWSTR wzFileName,
__in_z LPCWSTR wzNewExtension,
__out LPWSTR *ppwzFileNameNewExtension
);
HRESULT DAPI FileAddSuffixToBaseName(
__in_z LPCWSTR wzFileName,
__in_z LPCWSTR wzSuffix,
__out_z LPWSTR* psczNewFileName
);
HRESULT DAPI FileVersionFromString(
__in_z LPCWSTR wzVersion,
__out DWORD *pdwVerMajor,
__out DWORD* pdwVerMinor
);
HRESULT DAPI FileVersionFromStringEx(
__in_z LPCWSTR wzVersion,
__in SIZE_T cchVersion,
__out DWORD64* pqwVersion
);
HRESULT DAPI FileVersionToStringEx(
__in DWORD64 qwVersion,
__out LPWSTR* psczVersion
);
HRESULT DAPI FileSetPointer(
__in HANDLE hFile,
__in DWORD64 dw64Move,
__out_opt DWORD64* pdw64NewPosition,
__in DWORD dwMoveMethod
);
HRESULT DAPI FileSize(
__in_z LPCWSTR pwzFileName,
__out LONGLONG* pllSize
);
HRESULT DAPI FileSizeByHandle(
__in HANDLE hFile,
__out LONGLONG* pllSize
);
BOOL DAPI FileExistsEx(
__in_z LPCWSTR wzPath,
__out_opt DWORD *pdwAttributes
);
BOOL DAPI FileExistsAfterRestart(
__in_z LPCWSTR wzPath,
__out_opt DWORD *pdwAttributes
);
HRESULT DAPI FileRemoveFromPendingRename(
__in_z LPCWSTR wzPath
);
HRESULT DAPI FileRead(
__deref_out_bcount_full(*pcbDest) LPBYTE* ppbDest,
__out SIZE_T* pcbDest,
__in_z LPCWSTR wzSrcPath
);
HRESULT DAPI FileReadEx(
__deref_out_bcount_full(*pcbDest) LPBYTE* ppbDest,
__out SIZE_T* pcbDest,
__in_z LPCWSTR wzSrcPath,
__in DWORD dwShareMode
);
HRESULT DAPI FileReadUntil(
__deref_out_bcount_full(*pcbDest) LPBYTE* ppbDest,
__out_range(<=, cbMaxRead) SIZE_T* pcbDest,
__in_z LPCWSTR wzSrcPath,
__in DWORD cbMaxRead
);
HRESULT DAPI FileReadPartial(
__deref_out_bcount_full(*pcbDest) LPBYTE* ppbDest,
__out_range(<=, cbMaxRead) SIZE_T* pcbDest,
__in_z LPCWSTR wzSrcPath,
__in BOOL fSeek,
__in DWORD cbStartPosition,
__in DWORD cbMaxRead,
__in BOOL fPartialOK
);
HRESULT DAPI FileReadPartialEx(
__deref_inout_bcount_full(*pcbDest) LPBYTE* ppbDest,
__out_range(<=, cbMaxRead) SIZE_T* pcbDest,
__in_z LPCWSTR wzSrcPath,
__in BOOL fSeek,
__in DWORD cbStartPosition,
__in DWORD cbMaxRead,
__in BOOL fPartialOK,
__in DWORD dwShareMode
);
HRESULT DAPI FileReadHandle(
__in HANDLE hFile,
__in_bcount(cbDest) LPBYTE pbDest,
__in SIZE_T cbDest
);
HRESULT DAPI FileWrite(
__in_z LPCWSTR pwzFileName,
__in DWORD dwFlagsAndAttributes,
__in_bcount_opt(cbData) LPCBYTE pbData,
__in SIZE_T cbData,
__out_opt HANDLE* pHandle
);
HRESULT DAPI FileWriteHandle(
__in HANDLE hFile,
__in_bcount_opt(cbData) LPCBYTE pbData,
__in SIZE_T cbData
);
HRESULT DAPI FileCopyUsingHandles(
__in HANDLE hSource,
__in HANDLE hTarget,
__in DWORD64 cbCopy,
__out_opt DWORD64* pcbCopied
);
HRESULT DAPI FileCopyUsingHandlesWithProgress(
__in HANDLE hSource,
__in HANDLE hTarget,
__in DWORD64 cbCopy,
__in_opt LPPROGRESS_ROUTINE lpProgressRoutine,
__in_opt LPVOID lpData
);
HRESULT DAPI FileEnsureCopy(
__in_z LPCWSTR wzSource,
__in_z LPCWSTR wzTarget,
__in BOOL fOverwrite
);
HRESULT DAPI FileEnsureCopyWithRetry(
__in LPCWSTR wzSource,
__in LPCWSTR wzTarget,
__in BOOL fOverwrite,
__in DWORD cRetry,
__in DWORD dwWaitMilliseconds
);
HRESULT DAPI FileEnsureMove(
__in_z LPCWSTR wzSource,
__in_z LPCWSTR wzTarget,
__in BOOL fOverwrite,
__in BOOL fAllowCopy
);
HRESULT DAPI FileEnsureMoveWithRetry(
__in LPCWSTR wzSource,
__in LPCWSTR wzTarget,
__in BOOL fOverwrite,
__in BOOL fAllowCopy,
__in DWORD cRetry,
__in DWORD dwWaitMilliseconds
);
HRESULT DAPI FileCreateTemp(
__in_z LPCWSTR wzPrefix,
__in_z LPCWSTR wzExtension,
__deref_opt_out_z LPWSTR* ppwzTempFile,
__out_opt HANDLE* phTempFile
);
HRESULT DAPI FileCreateTempW(
__in_z LPCWSTR wzPrefix,
__in_z LPCWSTR wzExtension,
__deref_opt_out_z LPWSTR* ppwzTempFile,
__out_opt HANDLE* phTempFile
);
HRESULT DAPI FileVersion(
__in_z LPCWSTR wzFilename,
__out DWORD *pdwVerMajor,
__out DWORD* pdwVerMinor
);
HRESULT DAPI FileIsSame(
__in_z LPCWSTR wzFile1,
__in_z LPCWSTR wzFile2,
__out LPBOOL lpfSameFile
);
HRESULT DAPI FileEnsureDelete(
__in_z LPCWSTR wzFile
);
HRESULT DAPI FileGetTime(
__in_z LPCWSTR wzFile,
__out_opt LPFILETIME lpCreationTime,
__out_opt LPFILETIME lpLastAccessTime,
__out_opt LPFILETIME lpLastWriteTime
);
HRESULT DAPI FileSetTime(
__in_z LPCWSTR wzFile,
__in_opt const FILETIME *lpCreationTime,
__in_opt const FILETIME *lpLastAccessTime,
__in_opt const FILETIME *lpLastWriteTime
);
HRESULT DAPI FileResetTime(
__in_z LPCWSTR wzFile
);
HRESULT DAPI FileExecutableArchitecture(
__in_z LPCWSTR wzFile,
__out FILE_ARCHITECTURE *pArchitecture
);
HRESULT DAPI FileToString(
__in_z LPCWSTR wzFile,
__out LPWSTR *psczString,
__out_opt FILE_ENCODING *pfeEncoding
);
HRESULT DAPI FileFromString(
__in_z LPCWSTR wzFile,
__in DWORD dwFlagsAndAttributes,
__in_z LPCWSTR sczString,
__in FILE_ENCODING feEncoding
);
#ifdef __cplusplus
}
#endif
|
