Skip to content

Commit a97588b

Browse files
author
Colin Robertson
committed
Prep for metadata changes, remove includes
1 parent 829325e commit a97588b

16 files changed

Lines changed: 101 additions & 109 deletions

docs/c-runtime-library/includes/vs2012_upd01_md.md

Lines changed: 0 additions & 1 deletion
This file was deleted.

docs/c-runtime-library/includes/win2kfamily_md.md

Lines changed: 0 additions & 1 deletion
This file was deleted.

docs/c-runtime-library/path-field-limits.md

Lines changed: 24 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -18,25 +18,28 @@ manager: "ghogen"
1818
ms.workload: ["cplusplus"]
1919
---
2020
# Path Field Limits
21-
## Syntax
22-
23-
```
24-
#include <stdlib.h>
25-
```
26-
27-
## Remarks
28-
These constants define the maximum length for the path and for the individual fields within the path.
29-
30-
|Constant|Meaning|
31-
|--------------|-------------|
32-
|`_MAX_DIR`|Maximum length of directory component|
33-
|`_MAX_DRIVE`|Maximum length of drive component|
34-
|`_MAX_EXT`|Maximum length of extension component|
35-
|`_MAX_FNAME`|Maximum length of filename component|
36-
|`_MAX_PATH`|Maximum length of full path|
37-
21+
22+
## Syntax
23+
24+
```cpp
25+
#include <stdlib.h>
26+
```
27+
28+
## Remarks
29+
30+
These constants define the maximum length for the path and for the individual fields within the path.
31+
32+
|Constant|Meaning|
33+
|--------------|-------------|
34+
|`_MAX_DIR`|Maximum length of directory component|
35+
|`_MAX_DRIVE`|Maximum length of drive component|
36+
|`_MAX_EXT`|Maximum length of extension component|
37+
|`_MAX_FNAME`|Maximum length of filename component|
38+
|`_MAX_PATH`|Maximum length of full path|
39+
3840
> [!NOTE]
39-
> The C Runtime supports path lengths up to 32768 characters in length, but it is up to the operating system, specifically the file system, to support these longer paths. The sum of the fields should not exceed `_MAX_PATH` for full backwards compatibility with FAT32 file systems. [!INCLUDE[win2kfamily](../c-runtime-library/includes/win2kfamily_md.md)], [!INCLUDE[WinXpFamily](../atl/reference/includes/winxpfamily_md.md)], [!INCLUDE[WinXPSvr](../build/includes/winxpsvr_md.md)], and Windows Vista NTFS file system supports paths up to 32768 characters in length, but only when using the Unicode APIs. When using long path names, prefix the path with the characters \\\\?\ and use the Unicode versions of the C Runtime functions.
40-
41-
## See Also
42-
[Global Constants](../c-runtime-library/global-constants.md)
41+
> The C Runtime supports path lengths up to 32768 characters in length, but it is up to the operating system, specifically the file system, to support these longer paths. The sum of the fields should not exceed `_MAX_PATH` for full backwards compatibility with FAT32 file systems. The Windows NTFS file system supports paths up to 32768 characters in length, but only when using the Unicode APIs. When using long path names, prefix the path with the characters \\\\?\ and use the Unicode versions of the C Runtime functions.
42+
43+
## See also
44+
45+
[Global Constants](../c-runtime-library/global-constants.md)

docs/c-runtime-library/reference/includes/wiprlhext_md.md

Lines changed: 0 additions & 1 deletion
This file was deleted.
Lines changed: 23 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "Fatal Error C1189 | Microsoft Docs"
33
ms.custom: ""
4-
ms.date: "11/04/2016"
4+
ms.date: "04/27/2018"
55
ms.reviewer: ""
66
ms.suite: ""
77
ms.technology: ["cpp-tools"]
@@ -18,35 +18,25 @@ manager: "ghogen"
1818
ms.workload: ["cplusplus"]
1919
---
2020
# Fatal Error C1189
21-
\#error : user supplied error message
22-
23-
C1189 is generated by the `#error` directive. The developer who codes the directive specifies the text of the error message. For more information, see [#error Directive (C/C++)](../../preprocessor/hash-error-directive-c-cpp.md).
24-
25-
The following sample generates C1189. In the sample, the developer issues a custom error message because the `_WIN32` identifier is not defined:
26-
27-
```
28-
// C1189.cpp
29-
#undef _WIN32
30-
#if !defined(_WIN32)
31-
#error _WIN32 must be defined // C1189
32-
#endif
33-
```
34-
35-
You might also see this error if you build an ATL project by using the **/robust** MIDL compiler option. Use the **/robust** switch to build only [!INCLUDE[win2kfamily](../../c-runtime-library/includes/win2kfamily_md.md)] and later versions of Windows. To correct this error, use one of the following procedures:
36-
37-
- Change this line in the dlldatax.c file:
38-
39-
```
40-
#define _WIN32_WINNT 0x0400 // for WinNT 4.0 or Windows 95 with DCOM
41-
```
42-
43-
to:
44-
45-
```
46-
#define _WIN32_WINNT 0x0500 // for WinNT 4.0 or Windows 95 with DCOM
47-
```
48-
49-
- Use the **Advanced** property page in the **MIDL** property page folder to remove the **/robust** switch and then specify the **/no_robust** switch. For more information, see [MIDL Property Pages: Advanced](../../ide/midl-property-pages-advanced.md).
50-
51-
## See Also
52-
[#define Directive (C/C++)](../../preprocessor/hash-define-directive-c-cpp.md)
21+
22+
> **\#error :** *user supplied error message*
23+
24+
## Remarks
25+
26+
C1189 is generated by the `#error` directive. The developer who codes the directive specifies the text of the error message. For more information, see [#error Directive (C/C++)](../../preprocessor/hash-error-directive-c-cpp.md).
27+
28+
## Example
29+
30+
The following sample generates C1189. In the sample, the developer issues a custom error message because the `_WIN32` identifier is not defined:
31+
32+
```cpp
33+
// C1189.cpp
34+
#undef _WIN32
35+
#if !defined(_WIN32)
36+
#error _WIN32 must be defined // C1189
37+
#endif
38+
```
39+
40+
## See also
41+
42+
[#define Directive (C/C++)](../../preprocessor/hash-define-directive-c-cpp.md)

docs/ide/linker-property-pages.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ To programmatically access this property, see <xref:Microsoft.VisualStudio.VCPro
3737

3838
### Per-user Redirection
3939

40-
Registration in Visual Studio has traditionally been done in HKEY_CLASSES_ROOT (HKCR). With [!INCLUDE[wiprlhext](../c-runtime-library/reference/includes/wiprlhext_md.md)], to access HKCR you must run Visual Studio in elevated mode. Developers do not always want to run in elevated mode but still must work with registration. Per-user redirection allows you to register without having to run in this mode.
40+
Registration in Visual Studio has traditionally been done in HKEY_CLASSES_ROOT (HKCR). With Windows Vista and later operating systems, to access HKCR you must run Visual Studio in elevated mode. Developers do not always want to run in elevated mode but still must work with registration. Per-user redirection allows you to register without having to run in this mode.
4141

4242
Per-user redirection forces any writes to HKCR to be redirected to HKEY\_CURRENT\_USER (HKCU). If per-user redirection is turned off, it can cause [Project Build Error PRJ0050](../error-messages/tool-errors/project-build-error-prj0050.md) when the program tries to write to HKCR.
4343

docs/mfc/how-to-add-restart-manager-support.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,14 +17,15 @@ manager: "ghogen"
1717
ms.workload: ["cplusplus"]
1818
---
1919
# How to: Add Restart Manager Support
20-
The restart manager is a feature added to [!INCLUDE[vsprvs](../assembler/masm/includes/vsprvs_md.md)] for [!INCLUDE[wiprlhext](../c-runtime-library/reference/includes/wiprlhext_md.md)]. The restart manager adds support for your application if it unexpectedly closes or restarts. The behavior of the restart manager depends on the type of your application. If your application is a document editor, the restart manager enabled your application to automatically save the state and content of any open documents and restarts your application after an unexpected closure. If your application is not a document editor, the restart manager will restart the application, but it cannot save the state of the application by default.
20+
21+
The restart manager is a feature added to Visual Studio for Windows Vista or later operating systems. The restart manager adds support for your application if it unexpectedly closes or restarts. The behavior of the restart manager depends on the type of your application. If your application is a document editor, the restart manager enabled your application to automatically save the state and content of any open documents and restarts your application after an unexpected closure. If your application is not a document editor, the restart manager will restart the application, but it cannot save the state of the application by default.
2122

2223
After restart, the application displays a task dialog box if the application is Unicode. If it is an ANSI application, the application displays a Windows Message box. At this point, the user chooses whether to restore the automatically saved documents. If the user does not restore the automatically saved documents, the restart manager discards the temporary files.
2324

2425
> [!NOTE]
2526
> You can override the default behavior of the restart manager for saving data and restarting the application.
2627
27-
By default, MFC applications created by using the project wizard in [!INCLUDE[vsprvs](../assembler/masm/includes/vsprvs_md.md)] support the restart manager when the applications are run on a computer that has [!INCLUDE[wiprlhext](../c-runtime-library/reference/includes/wiprlhext_md.md)]. If you do not want your application to support the restart manager, you can disable the restart manager in the new project wizard.
28+
By default, MFC applications created by using the project wizard in [!INCLUDE[vsprvs](../assembler/masm/includes/vsprvs_md.md)] support the restart manager when the applications are run on a computer that has a Windows Vista or later operating system. If you do not want your application to support the restart manager, you can disable the restart manager in the new project wizard.
2829

2930
### To Add Support For the Restart Manager to an Existing Application
3031

docs/mfc/reference/application-information-and-management.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -634,7 +634,8 @@ void AFXAPI AfxSetPerUserRegistration(BOOL bEnable);
634634
`TRUE` indicates that the registry information is directed to the **HKCU** node; `FALSE` indicates that the application writes registry information to the default node. The default node is **HKEY_CLASSES_ROOT** ( **HKCR**).
635635

636636
### Remarks
637-
Before [!INCLUDE[wiprlhext](../../c-runtime-library/reference/includes/wiprlhext_md.md)], applications that access the registry usually use the **HKEY_CLASSES_ROOT** node. However, with [!INCLUDE[wiprlhext](../../c-runtime-library/reference/includes/wiprlhext_md.md)], you must run an application in elevated mode to write to **HKCR**.
637+
638+
Before Windows Vista, applications that accessed the registry usually used the **HKEY_CLASSES_ROOT** node. However, with Windows Vista or later operating systems, you must run an application in elevated mode to write to **HKCR**.
638639

639640
This method enables your application to read and write to the registry without running in elevated mode by redirecting registry access from **HKCR** to **HKCU**. For more information, see [Linker Property Pages](../../ide/linker-property-pages.md).
640641

docs/mfc/reference/cdialog-class.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -401,7 +401,7 @@ virtual BOOL OnInitDialog();
401401
Windows calls the `OnInitDialog` function by using the standard global dialog-box procedure common to all Microsoft Foundation Class Library dialog boxes. It does not call this function through your message map, and therefore you do not need a message map entry for this method.
402402

403403
> [!NOTE]
404-
> You cannot override this method when you use a `CFileDialog` object in a program that is compiled under [!INCLUDE[wiprlhext](../../c-runtime-library/reference/includes/wiprlhext_md.md)]. For more information about changes to `CFileDialog` under [!INCLUDE[wiprlhext](../../c-runtime-library/reference/includes/wiprlhext_md.md)] see [CFileDialog Class](../../mfc/reference/cfiledialog-class.md).
404+
> You cannot override this method when you use a `CFileDialog` object in a program that is compiled under Windows Vista or later operating systems. For more information about changes to `CFileDialog` under Windows Vista and later, see [CFileDialog Class](../../mfc/reference/cfiledialog-class.md).
405405
406406
### Example
407407
[!code-cpp[NVC_MFCControlLadenDialog#67](../../mfc/codesnippet/cpp/cdialog-class_6.cpp)]
@@ -441,7 +441,7 @@ Virtual void OnSetFont(CFont* pFont);
441441
The dialog editor typically sets the dialog-box font as part of the dialog-box template resource.
442442

443443
> [!NOTE]
444-
> You cannot override this method when you use a `CFileDialog` object in a program that is compiled under [!INCLUDE[wiprlhext](../../c-runtime-library/reference/includes/wiprlhext_md.md)]. For more information about changes to `CFileDialog` under [!INCLUDE[wiprlhext](../../c-runtime-library/reference/includes/wiprlhext_md.md)] see [CFileDialog Class](../../mfc/reference/cfiledialog-class.md).
444+
> You cannot override this method when you use a `CFileDialog` object in a program that is compiled under Windows Vista or later operating systems. For more information about changes to `CFileDialog` under Windows Vista and later, see [CFileDialog Class](../../mfc/reference/cfiledialog-class.md).
445445
446446
## <a name="prevdlgctrl"></a> CDialog::PrevDlgCtrl
447447
Sets the focus to the previous control in the dialog box.

0 commit comments

Comments
 (0)