Skip to content

Commit 364ae84

Browse files
author
mikeblome
committed
Merge branch 'master' of github.com:MicrosoftDocs/cpp-docs-pr into mb-toc-build
merge from master
2 parents 3056d18 + de66ba3 commit 364ae84

File tree

145 files changed

+5148
-6069
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

145 files changed

+5148
-6069
lines changed

.openpublishing.redirection.json

+405
Large diffs are not rendered by default.

docs/atl-mfc-shared/date-and-time-systemtime-support.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ ms.assetid: 201528e4-2ffa-48fc-af8f-203aa86d942a
99

1010
The [CTime](../atl-mfc-shared/reference/ctime-class.md) class has constructors that accept system and file times from Win32. If you use `CTime` objects for these purposes, you must modify their initialization accordingly, as described in this article.
1111

12-
For information about the SYSTEMTIME structure, see [SYSTEMTIME](https://msdn.microsoft.com/library/windows/desktop/ms724950). For information about the FILETIME structure, see [FILETIME](https://msdn.microsoft.com/library/windows/desktop/ms724284).
12+
For information about the SYSTEMTIME structure, see [SYSTEMTIME](/windows/desktop/api/minwinbase/ns-minwinbase-systemtime). For information about the FILETIME structure, see [FILETIME](/windows/desktop/api/minwinbase/ns-minwinbase-filetime).
1313

1414
MFC still provides `CTime` constructors that take time arguments in the MS-DOS style, but, starting in MFC version 3.0, the `CTime` class also supports a constructor that takes a Win32 `SYSTEMTIME` structure and another that takes a Win32 `FILETIME` structure.
1515

docs/atl-mfc-shared/reference/cfiletime-class.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -102,7 +102,7 @@ CFileTime(ULONGLONG nTime) throw();
102102
### Parameters
103103

104104
*ft*<br/>
105-
A [FILETIME](https://msdn.microsoft.com/library/windows/desktop/ms724284) structure.
105+
A [FILETIME](/windows/desktop/api/minwinbase/ns-minwinbase-filetime) structure.
106106

107107
*nTime*<br/>
108108
The date and time expressed as a 64-bit value.
@@ -453,7 +453,7 @@ See the example for [CFileTime::Millisecond](#millisecond).
453453

454454
## See Also
455455

456-
[FILETIME](https://msdn.microsoft.com/library/windows/desktop/ms724284)<br/>
456+
[FILETIME](/windows/desktop/api/minwinbase/ns-minwinbase-filetime)<br/>
457457
[CFileTimeSpan Class](../../atl-mfc-shared/reference/cfiletimespan-class.md)<br/>
458458
[Hierarchy Chart](../../mfc/hierarchy-chart.md)<br/>
459459
[ATL/MFC Shared Classes](../../atl-mfc-shared/atl-mfc-shared-classes.md)

docs/atl-mfc-shared/reference/cfiletimespan-class.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -294,7 +294,7 @@ The new value for the time span in milliseconds.
294294

295295
## See Also
296296

297-
[FILETIME](https://msdn.microsoft.com/library/windows/desktop/ms724284)<br/>
297+
[FILETIME](/windows/desktop/api/minwinbase/ns-minwinbase-filetime)<br/>
298298
[CFileTime Class](../../atl-mfc-shared/reference/cfiletime-class.md)<br/>
299299
[Hierarchy Chart](../../mfc/hierarchy-chart.md)<br/>
300300
[ATL/MFC Shared Classes](../../atl-mfc-shared/atl-mfc-shared-classes.md)

docs/atl-mfc-shared/reference/coledatetime-class.md

+6-6
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ class COleDateTime
2929
|----------|-----------------|
3030
|[COleDateTime::Format](#format)|Generates a formatted string representation of a `COleDateTime` object.|
3131
|[COleDateTime::GetAsDBTIMESTAMP](#getasdbtimestamp)|Call this method to obtain the time in the `COleDateTime` object as a `DBTIMESTAMP` data structure.|
32-
|[COleDateTime::GetAsSystemTime](#getassystemtime)|Call this method to obtain the time in the `COleDateTime` object as a [SYSTEMTIME](https://msdn.microsoft.com/library/windows/desktop/ms724950) data structure.|
32+
|[COleDateTime::GetAsSystemTime](#getassystemtime)|Call this method to obtain the time in the `COleDateTime` object as a [SYSTEMTIME](/windows/desktop/api/minwinbase/ns-minwinbase-systemtime) data structure.|
3333
|[COleDateTime::GetAsUDATE](#getasudate)|Call this method to obtain the time in the `COleDateTime` as a `UDATE` data structure.|
3434
|[COleDateTime::GetCurrentTime](#getcurrenttime)|Creates a `COleDateTime` object that represents the current time (static member function).|
3535
|[COleDateTime::GetDay](#getday)|Returns the day this `COleDateTime` object represents (1 - 31).|
@@ -228,7 +228,7 @@ Following is a brief description of each constructor:
228228

229229
For more information on the `time_t` data type, see the [time](../../c-runtime-library/reference/time-time32-time64.md) function in the *Run-Time Library Reference*.
230230

231-
For more information, see the [SYSTEMTIME](https://msdn.microsoft.com/library/windows/desktop/ms724950) and [FILETIME](https://msdn.microsoft.com/library/windows/desktop/ms724284) structures in the Windows SDK.
231+
For more information, see the [SYSTEMTIME](/windows/desktop/api/minwinbase/ns-minwinbase-systemtime) and [FILETIME](/windows/desktop/api/minwinbase/ns-minwinbase-filetime) structures in the Windows SDK.
232232

233233
For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
234234

@@ -336,7 +336,7 @@ bool GetAsSystemTime(SYSTEMTIME& sysTime) const throw();
336336
### Parameters
337337

338338
*sysTime*<br/>
339-
A reference to a [SYSTEMTIME](https://msdn.microsoft.com/library/windows/desktop/ms724950) structure to receive the converted date/time value from the `COleDateTime` object.
339+
A reference to a [SYSTEMTIME](/windows/desktop/api/minwinbase/ns-minwinbase-systemtime) structure to receive the converted date/time value from the `COleDateTime` object.
340340

341341
### Return Value
342342

@@ -798,17 +798,17 @@ These overloaded assignment operators copy the source date/time value into this
798798

799799
- **operator =(** `timeSrc` **)** The `time_t` or `__time64_t` value is converted and copied into this `COleDateTime` object. If the conversion is successful, the status of this object is set to valid; if unsuccessful, it is set to invalid.
800800

801-
- **operator =(** *systimeSrc* **)** The [SYSTEMTIME](https://msdn.microsoft.com/library/windows/desktop/ms724950) value is converted and copied into this `COleDateTime` object. If the conversion is successful, the status of this object is set to valid; if unsuccessful, it is set to invalid.
801+
- **operator =(** *systimeSrc* **)** The [SYSTEMTIME](/windows/desktop/api/minwinbase/ns-minwinbase-systemtime) value is converted and copied into this `COleDateTime` object. If the conversion is successful, the status of this object is set to valid; if unsuccessful, it is set to invalid.
802802

803803
- **operator =(** `udate` **)** The `UDATE` value is converted and copied into this `COleDateTime` object. If the conversion is successful, the status of this object is set to valid; if unsuccessful, it is set to invalid. A `UDATE` structure represents an "unpacked" date. See the function [VarDateFromUdate](/windows/desktop/api/oleauto/nf-oleauto-vardatefromudate) for more details.
804804

805-
- **operator =(** `filetimeSrc` **)** The [FILETIME](https://msdn.microsoft.com/library/windows/desktop/ms724284) value is converted and copied into this `COleDateTime` object. If the conversion is successful, the status of this object is set to valid; otherwise it is set to invalid. `FILETIME` uses Universal Coordinated Time (UTC), so if you pass a UTC time in the structure, your results will be converted from UTC time to local time, and will be stored as variant time. This behavior is the same as in Visual C++ 6.0 and Visual C++.NET 2003 SP2. See [File Times](/windows/desktop/SysInfo/file-times) in the Windows SDK for more information.
805+
- **operator =(** `filetimeSrc` **)** The [FILETIME](/windows/desktop/api/minwinbase/ns-minwinbase-filetime) value is converted and copied into this `COleDateTime` object. If the conversion is successful, the status of this object is set to valid; otherwise it is set to invalid. `FILETIME` uses Universal Coordinated Time (UTC), so if you pass a UTC time in the structure, your results will be converted from UTC time to local time, and will be stored as variant time. This behavior is the same as in Visual C++ 6.0 and Visual C++.NET 2003 SP2. See [File Times](/windows/desktop/SysInfo/file-times) in the Windows SDK for more information.
806806

807807
For more information, see the [VARIANT](/windows/desktop/api/oaidl/ns-oaidl-tagvariant) entry in the Windows SDK.
808808

809809
For more information on the `time_t` data type, see the [time](../../c-runtime-library/reference/time-time32-time64.md) function in the *Run-Time Library Reference*.
810810

811-
For more information, see the [SYSTEMTIME](https://msdn.microsoft.com/library/windows/desktop/ms724950) and [FILETIME](https://msdn.microsoft.com/library/windows/desktop/ms724284) structures in the Windows SDK.
811+
For more information, see the [SYSTEMTIME](/windows/desktop/api/minwinbase/ns-minwinbase-systemtime) and [FILETIME](/windows/desktop/api/minwinbase/ns-minwinbase-filetime) structures in the Windows SDK.
812812

813813
For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
814814

docs/atl-mfc-shared/reference/ctime-class.md

+6-6
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ class CTime
3030
|[CTime::Format](#format)|Converts a `CTime` object into a formatted string — based on the local time zone.|
3131
|[CTime::FormatGmt](#formatgmt)|Converts a `CTime` object into a formatted string — based on UTC.|
3232
|[CTime::GetAsDBTIMESTAMP](#getasdbtimestamp)|Converts the time information stored in the `CTime` object to a Win32-compatible DBTIMESTAMP structure.|
33-
|[CTime::GetAsSystemTime](#getassystemtime)|Converts the time information stored in the `CTime` object to a Win32-compatible [SYSTEMTIME](https://msdn.microsoft.com/library/windows/desktop/ms724950) structure.|
33+
|[CTime::GetAsSystemTime](#getassystemtime)|Converts the time information stored in the `CTime` object to a Win32-compatible [SYSTEMTIME](/windows/desktop/api/minwinbase/ns-minwinbase-systemtime) structure.|
3434
|[CTime::GetCurrentTime](#getcurrenttime)|Creates a `CTime` object that represents the current time (static member function).|
3535
|[CTime::GetDay](#getday)|Returns the day represent by the `CTime` object.|
3636
|[CTime::GetDayOfWeek](#getdayofweek)|Returns the day of the week represented by the `CTime` object.|
@@ -142,10 +142,10 @@ Indicates whether daylight savings time is in effect. Can have one of three valu
142142
MS-DOS date and time values to be converted to a date/time value and copied into the new `CTime` object.
143143

144144
*st*<br/>
145-
A [SYSTEMTIME](https://msdn.microsoft.com/library/windows/desktop/ms724950) structure to be converted to a date/time value and copied into the new `CTime` object.
145+
A [SYSTEMTIME](/windows/desktop/api/minwinbase/ns-minwinbase-systemtime) structure to be converted to a date/time value and copied into the new `CTime` object.
146146

147147
*ft*<br/>
148-
A [FILETIME](https://msdn.microsoft.com/library/windows/desktop/ms724284) structure to be converted to a date/time value and copied into the new `CTime` object.
148+
A [FILETIME](/windows/desktop/api/minwinbase/ns-minwinbase-filetime) structure to be converted to a date/time value and copied into the new `CTime` object.
149149

150150
*dbts*<br/>
151151
A reference to a DBTIMESTAMP structure containing the current local time.
@@ -182,7 +182,7 @@ Each constructor is described below:
182182
> [!NOTE]
183183
> The constructor using `DBTIMESTAMP` parameter is only available when OLEDB.h is included.
184184
185-
For more information, see the [SYSTEMTIME](https://msdn.microsoft.com/library/windows/desktop/ms724950) and [FILETIME](https://msdn.microsoft.com/library/windows/desktop/ms724284) structure in the Windows SDK. Also see the [MS-DOS Date and Time](/windows/desktop/SysInfo/ms-dos-date-and-time) entry in the Windows SDK.
185+
For more information, see the [SYSTEMTIME](/windows/desktop/api/minwinbase/ns-minwinbase-systemtime) and [FILETIME](/windows/desktop/api/minwinbase/ns-minwinbase-filetime) structure in the Windows SDK. Also see the [MS-DOS Date and Time](/windows/desktop/SysInfo/ms-dos-date-and-time) entry in the Windows SDK.
186186

187187
### Example
188188

@@ -277,7 +277,7 @@ Stores the resulting time in the referenced *dbts* structure. The `DBTIMESTAMP`
277277

278278
## <a name="getassystemtime"></a> CTime::GetAsSystemTime
279279

280-
Call this member function to convert the time information stored in the `CTime` object to a Win32-compatible [SYSTEMTIME](https://msdn.microsoft.com/library/windows/desktop/ms724950) structure.
280+
Call this member function to convert the time information stored in the `CTime` object to a Win32-compatible [SYSTEMTIME](/windows/desktop/api/minwinbase/ns-minwinbase-systemtime) structure.
281281

282282
```
283283
bool GetAsSystemTime(SYSTEMTIME& st) const throw();
@@ -286,7 +286,7 @@ bool GetAsSystemTime(SYSTEMTIME& st) const throw();
286286
### Parameters
287287

288288
*timeDest*<br/>
289-
A reference to a [SYSTEMTIME](https://msdn.microsoft.com/library/windows/desktop/ms724950) structure that will hold the converted date/time value of the `CTime` object.
289+
A reference to a [SYSTEMTIME](/windows/desktop/api/minwinbase/ns-minwinbase-systemtime) structure that will hold the converted date/time value of the `CTime` object.
290290

291291
### Return Value
292292

docs/atl/reference/caccesstoken-class.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -170,7 +170,7 @@ Returns TRUE on success, FALSE on failure.
170170

171171
### Remarks
172172

173-
`CreateImpersonationToken` calls [DuplicateToken](https://msdn.microsoft.com/library/windows/desktop/aa446616) to create a new impersonation token.
173+
`CreateImpersonationToken` calls [DuplicateToken](/windows/desktop/api/securitybaseapi/nf-securitybaseapi-duplicatetoken) to create a new impersonation token.
174174

175175
## <a name="createprimarytoken"></a> CAccessToken::CreatePrimaryToken
176176

@@ -607,7 +607,7 @@ Returns TRUE on success, FALSE on failure.
607607

608608
### Remarks
609609

610-
Calls the [OpenProcessToken](https://msdn.microsoft.com/library/aa379295) Win32 function.
610+
Calls the [OpenProcessToken](/windows/desktop/api/processthreadsapi/nf-processthreadsapi-openprocesstoken) Win32 function.
611611

612612
## <a name="getprofile"></a> CAccessToken::GetProfile
613613

@@ -1039,7 +1039,7 @@ Returns TRUE on success, FALSE on failure.
10391039

10401040
### Remarks
10411041

1042-
When `PrivilegeCheck` returns, the `Attributes` member of each [LUID_AND_ATTRIBUTES](/windows/desktop/api/winnt/ns-winnt-_luid_and_attributes) structure is set to SE_PRIVILEGE_USED_FOR_ACCESS if the corresponding privilege is enabled. This method calls the [PrivilegeCheck](https://msdn.microsoft.com/library/windows/desktop/aa379304) Win32 function.
1042+
When `PrivilegeCheck` returns, the `Attributes` member of each [LUID_AND_ATTRIBUTES](/windows/desktop/api/winnt/ns-winnt-_luid_and_attributes) structure is set to SE_PRIVILEGE_USED_FOR_ACCESS if the corresponding privilege is enabled. This method calls the [PrivilegeCheck](/windows/desktop/api/securitybaseapi/nf-securitybaseapi-privilegecheck) Win32 function.
10431043

10441044
## <a name="revert"></a> CAccessToken::Revert
10451045

docs/atl/reference/catlexemodulet-class.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -260,7 +260,7 @@ HRESULT Run(int nShowCmd = SW_HIDE) throw();
260260
### Parameters
261261

262262
*nShowCmd*<br/>
263-
Specifies how the window is to be shown. This parameter can be one of the values discussed in the [WinMain](https://msdn.microsoft.com/library/windows/desktop/ms633559) section. Defaults to SW_HIDE.
263+
Specifies how the window is to be shown. This parameter can be one of the values discussed in the [WinMain](/windows/desktop/api/winbase/nf-winbase-winmain) section. Defaults to SW_HIDE.
264264

265265
### Return Value
266266

@@ -317,7 +317,7 @@ int WinMain(int nShowCmd) throw();
317317
### Parameters
318318

319319
*nShowCmd*<br/>
320-
Specifies how the window is to be shown. This parameter can be one of the values discussed in the [WinMain](https://msdn.microsoft.com/library/windows/desktop/ms633559) section.
320+
Specifies how the window is to be shown. This parameter can be one of the values discussed in the [WinMain](/windows/desktop/api/winbase/nf-winbase-winmain) section.
321321

322322
### Return Value
323323

docs/atl/reference/catlfilemappingbase-class.md

+5-5
Original file line numberDiff line numberDiff line change
@@ -175,15 +175,15 @@ The file offset where mapping is to begin. The offset value must be a multiple o
175175
The protection desired for the file view when the file is mapped. See *flProtect* in [CreateFileMapping](/windows/desktop/api/winbase/nf-winbase-createfilemappinga) in the Windows SDK.
176176

177177
*dwViewDesiredAccess*<br/>
178-
Specifies the type of access to the file view and, therefore, the protection of the pages mapped by the file. See *dwDesiredAccess* in [MapViewOfFileEx](https://msdn.microsoft.com/library/windows/desktop/aa366763) in the Windows SDK.
178+
Specifies the type of access to the file view and, therefore, the protection of the pages mapped by the file. See *dwDesiredAccess* in [MapViewOfFileEx](/windows/desktop/api/memoryapi/nf-memoryapi-mapviewoffileex) in the Windows SDK.
179179

180180
### Return Value
181181

182182
Returns S_OK on success, or an error HRESULT on failure.
183183

184184
### Remarks
185185

186-
After a file-mapping object has been created, the size of the file must not exceed the size of the file-mapping object; if it does, not all of the file's contents will be available for sharing. For more details, see [CreateFileMapping](/windows/desktop/api/winbase/nf-winbase-createfilemappinga) and [MapViewOfFileEx](https://msdn.microsoft.com/library/windows/desktop/aa366763) in the Windows SDK.
186+
After a file-mapping object has been created, the size of the file must not exceed the size of the file-mapping object; if it does, not all of the file's contents will be available for sharing. For more details, see [CreateFileMapping](/windows/desktop/api/winbase/nf-winbase-createfilemappinga) and [MapViewOfFileEx](/windows/desktop/api/memoryapi/nf-memoryapi-mapviewoffileex) in the Windows SDK.
187187

188188
### Example
189189

@@ -221,7 +221,7 @@ The pointer to a `SECURITY_ATTRIBUTES` structure that determines whether the ret
221221
The protection desired for the file view, when the file is mapped. See *flProtect* in `CreateFileMapping` in the Windows SDK.
222222

223223
*dwViewDesiredAccess*<br/>
224-
Specifies the type of access to the file view and, therefore, the protection of the pages mapped by the file. See *dwDesiredAccess* in [MapViewOfFileEx](https://msdn.microsoft.com/library/windows/desktop/aa366763) in the Windows SDK.
224+
Specifies the type of access to the file view and, therefore, the protection of the pages mapped by the file. See *dwDesiredAccess* in [MapViewOfFileEx](/windows/desktop/api/memoryapi/nf-memoryapi-mapviewoffileex) in the Windows SDK.
225225

226226
### Return Value
227227

@@ -255,7 +255,7 @@ The mapping size. If 0, the maximum size of the file-mapping object is equal to
255255
The file offset where mapping is to begin. The offset value must be a multiple of the system's memory allocation granularity.
256256

257257
*dwViewDesiredAccess*<br/>
258-
Specifies the type of access to the file view and, therefore, the protection of the pages mapped by the file. See *dwDesiredAccess* in [MapViewOfFileEx](https://msdn.microsoft.com/library/windows/desktop/aa366763) in the Windows SDK.
258+
Specifies the type of access to the file view and, therefore, the protection of the pages mapped by the file. See *dwDesiredAccess* in [MapViewOfFileEx](/windows/desktop/api/memoryapi/nf-memoryapi-mapviewoffileex) in the Windows SDK.
259259

260260
### Return Value
261261

@@ -296,7 +296,7 @@ Returns S_OK on success, or an error HRESULT on failure.
296296

297297
### Remarks
298298

299-
See [UnmapViewOfFile](https://msdn.microsoft.com/library/windows/desktop/aa366882) in the Windows SDK for more details.
299+
See [UnmapViewOfFile](/windows/desktop/api/memoryapi/nf-memoryapi-unmapviewoffile) in the Windows SDK for more details.
300300

301301
## See Also
302302

docs/atl/reference/catlservicemodulet-class.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -395,7 +395,7 @@ HRESULT Run(int nShowCmd = SW_HIDE) throw();
395395
### Parameters
396396

397397
*nShowCmd*<br/>
398-
Specifies how the window is to be shown. This parameter can be one of the values discussed in the [WinMain](https://msdn.microsoft.com/library/windows/desktop/ms633559) section. The default value is SW_HIDE.
398+
Specifies how the window is to be shown. This parameter can be one of the values discussed in the [WinMain](/windows/desktop/api/winbase/nf-winbase-winmain) section. The default value is SW_HIDE.
399399

400400
### Return Value
401401

@@ -455,7 +455,7 @@ HRESULT Start(int nShowCmd) throw();
455455
### Parameters
456456

457457
*nShowCmd*<br/>
458-
Specifies how the window is to be shown. This parameter can be one of the values discussed in the [WinMain](https://msdn.microsoft.com/library/windows/desktop/ms633559) section.
458+
Specifies how the window is to be shown. This parameter can be one of the values discussed in the [WinMain](/windows/desktop/api/winbase/nf-winbase-winmain) section.
459459

460460
### Return Value
461461

@@ -516,7 +516,7 @@ int WinMain(int nShowCmd) throw();
516516
### Parameters
517517

518518
*nShowCmd*<br/>
519-
Specifies how the window is to be shown. This parameter can be one of the values discussed in the [WinMain](https://msdn.microsoft.com/library/windows/desktop/ms633559) section.
519+
Specifies how the window is to be shown. This parameter can be one of the values discussed in the [WinMain](/windows/desktop/api/winbase/nf-winbase-winmain) section.
520520

521521
### Return Value
522522

docs/atl/reference/caxdialogimpl-class.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -236,7 +236,7 @@ BOOL IsDialogMessage(LPMSG pMsg);
236236
### Parameters
237237

238238
*pMsg*<br/>
239-
Pointer to a [MSG](https://msdn.microsoft.com/library/windows/desktop/ms644958) structure that contains the message to be checked.
239+
Pointer to a [MSG](/windows/desktop/api/winuser/ns-winuser-msg) structure that contains the message to be checked.
240240

241241
### Return Value
242242

0 commit comments

Comments
 (0)