You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit b8ee49a
Browse filesBrowse the repository at this point in the historyBrowse files
Colin Robertson
authored
Merge pull request MicrosoftDocs#2279 from MicrosoftDocs/master637286175664604764
@@ -11,52 +11,51 @@ Specifies whether User Account Control (UAC) information is embedded in the prog
11
11
12
12
## Syntax
13
13
14
-
```
15
-
/MANIFESTUAC
16
-
/MANIFESTUAC:NO
17
-
/MANIFESTUAC:fragment
18
-
/MANIFESTUAC:level=_level
19
-
/MANIFESTUAC:uiAccess=_uiAccess
20
-
```
14
+
> **`/MANIFESTUAC`**\
15
+
> **`/MANIFESTUAC:NO`**\
16
+
> **`/MANIFESTUAC:`**_`level`_\
17
+
> **`/MANIFESTUAC:`**_`uiAccess`_\
18
+
> **`/MANIFESTUAC:`**_`fragment`_
21
19
22
20
### Parameters
23
21
24
-
*fragment*<br/>
25
-
A string that contains the `level` and `uiAccess` values. For more information, see the Remarks section later in this topic.
22
+
**`NO`**<br/>
23
+
The linker doesn't embed UAC information in the program manifest.
26
24
27
-
*_level*<br/>
28
-
One of *asInvoker*, *highestAvailable*, or *requireAdministrator*. Defaults to asInvoker. For more information, see the Remarks section later in this topic.
25
+
*`level`*<br/>
26
+
**`level=`** followed by one of **`'asInvoker'`**, **`'highestAvailable'`**, or **`'requireAdministrator'`**. Defaults to **`'asInvoker'`**. For more information, see the [Remarks](#remarks) section.
29
27
30
-
*_uiAccess*<br/>
31
-
**true** if you want the application to bypass user interface protection levels and drive input to higher-permission windows on the desktop; otherwise, **false**. Defaults to **false**. Set to **true** only for user interface accessibility applications.
28
+
*`uiAccess`*<br/>
29
+
**`uiAccess='true'`** if you want the application to bypass user interface protection levels and drive input to higher-permission windows on the desktop; otherwise, **`uiAccess='false'`**. Defaults to **`uiAccess='false'`**. Set this argument to **`uiAccess='true'`** only for user interface accessibility applications.
30
+
31
+
*`fragment`*<br/>
32
+
A string that contains the *`level`* and *`uiAccess`* values. May optionally be enclosed in double quotes. For more information, see the [Remarks](#remarks) section.
32
33
33
34
## Remarks
34
35
35
-
If you specify multiple /MANIFESTUAC options on the command-line, the last one entered takes precedence.
36
+
If you specify multiple **`/MANIFESTUAC`** options on the command-line, the last one entered takes precedence.
36
37
37
-
The choices for /MANIFESTUAC:level are as follows:
38
+
The choices for **`/MANIFESTUAC:`**_`level`_ are as follows:
38
39
39
-
-`asInvoker`: The application will run with the same permissions as the process that started it. The application can be elevated to a higher permission level by selecting **Run as Administrator**.
40
+
-**`level='asInvoker'`**: The application runs at the same permission level as the process that started it. You can elevate the application to a higher permission level by selecting **Run as Administrator**.
40
41
41
-
- highestAvailable: The application will run with the highest permission level that it can. If the user who starts the application is a member of the Administrators group, this option is the same as requireAdministrator. If the highest available permission level is higher than the level of the opening process, the system will prompt for credentials.
42
+
-**`level='highestAvailable'`**: The application runs at the highest permission level that it can. If the user who starts the application is a member of the Administrators group, this option is the same as **`level='requireAdministrator'`**. If the highest available permission level is higher than the level of the opening process, the system prompts for credentials.
42
43
43
-
- requireAdministrator: The application will run with administrator permissions. The user who starts the application must be a member of the Administrators group. If the opening process is not running with administrative permissions, the system will prompt for credentials.
44
+
-**`level='requireAdministrator'`**: The application runs using administrator permissions. The user who starts the application must be a member of the Administrators group. If the opening process isn't running with administrative permissions, the system prompts for credentials.
44
45
45
-
You can specify the level and uiAccess values in one step by using the /MANIFESTUAC:fragment option. The fragment must be in the following form:
46
+
You can specify both the *`level`* and *`uiAccess`* values in one step by using the **`/MANIFESTUAC:`**_`fragment`_ option. The fragment must be in the following form:
### To set this linker option in the Visual Studio development environment
50
+
For example:
52
51
53
-
1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md).
### To set this linker option in the Visual Studio development environment
56
55
57
-
1.Expand the **Linker**node.
56
+
1.Open the project's **Property Pages**dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md).
Returns the character read. To indicate a read error or end-of-file condition, **getchar** returns **EOF**, and **getwchar** returns **WEOF**. For **getchar**, use **ferror** or **feof** to check for an error or for end of file.
25
+
Returns the character read. These functions wait for input and don't return until input is available.
26
+
27
+
To indicate a read error or end-of-file condition, **getchar** returns **EOF**, and **getwchar** returns **WEOF**. For **getchar**, use **ferror** or **feof** to check for an error or for end of file.
26
28
27
29
## Remarks
28
30
29
-
Each routine reads a single character from **stdin** and increments the associated file pointer to point to the next character. **getchar** is the same as [_fgetchar](fgetc-fgetwc.md), but it is implemented as a function and as a macro.
31
+
Each routine reads a single character from **stdin** and increments the associated file pointer to point to the next character. **getchar** is the same as [_fgetchar](fgetc-fgetwc.md), but it's implemented as a function and as a macro.
30
32
31
-
These functions lock the calling thread and are therefore thread-safe. For a non-locking version, see [_getchar_nolock, _getwchar_nolock](getchar-nolock-getwchar-nolock.md).
33
+
These functions also lock the calling thread and are thread-safe. For a non-locking version, see [_getchar_nolock, _getwchar_nolock](getchar-nolock-getwchar-nolock.md).
32
34
33
35
By default, this function's global state is scoped to the application. To change this, see [Global state in the CRT](../global-state.md).
34
36
@@ -45,7 +47,7 @@ By default, this function's global state is scoped to the application. To change
45
47
|**getchar**|\<stdio.h>|
46
48
|**getwchar**|\<stdio.h> or \<wchar.h>|
47
49
48
-
The console is not supported in Universal Windows Platform (UWP) apps. The standard stream handles that are associated with the console, **stdin**, **stdout**, and **stderr**, must be redirected before C run-time functions can use them in UWP apps. For additional compatibility information, see [Compatibility](../../c-runtime-library/compatibility.md).
50
+
The console isn't supported in Universal Windows Platform (UWP) apps. The standard stream handles that are associated with the console, **stdin**, **stdout**, and **stderr**, must be redirected before C run-time functions can use them in UWP apps. For additional compatibility information, see [Compatibility](../../c-runtime-library/compatibility.md).
Write formatted data to a string. More secure versions of some of these functions are available; see [sprintf_s, _sprintf_s_l, swprintf_s, _swprintf_s_l](sprintf-s-sprintf-s-l-swprintf-s-swprintf-s-l.md). The secure versions of **swprintf** and **_swprintf_l**do not take a *count* parameter.
14
+
Write formatted data to a string. More secure versions of some of these functions are available; see [sprintf_s, _sprintf_s_l, swprintf_s, _swprintf_s_l](sprintf-s-sprintf-s-l-swprintf-s-swprintf-s-l.md). The secure versions of **swprintf** and **_swprintf_l**take the size of the buffer as a parameter.
15
15
16
16
## Syntax
17
17
@@ -91,9 +91,9 @@ The number of characters written, or -1 if an error occurred. If *buffer* or *fo
91
91
The **sprintf** function formats and stores a series of characters and values in *buffer*. Each *argument* (if any) is converted and output according to the corresponding format specification in *format*. The format consists of ordinary characters and has the same form and function as the *format* argument for [printf](printf-printf-l-wprintf-wprintf-l.md). A null character is appended after the last character written. If copying occurs between strings that overlap, the behavior is undefined.
92
92
93
93
> [!IMPORTANT]
94
-
> Using **sprintf**, there is no way to limit the number of characters written, which means that code using **sprintf** is susceptible to buffer overruns. Consider using the related function [_snprintf](snprintf-snprintf-snprintf-l-snwprintf-snwprintf-l.md), which specifies a maximum number of characters to be written to *buffer*, or use [_scprintf](scprintf-scprintf-l-scwprintf-scwprintf-l.md) to determine how large a buffer is required. Also, ensure that *format* is not a user-defined string.
94
+
> Using **sprintf**, there is no way to limit the number of characters written, which means that code using **sprintf** is susceptible to buffer overruns. Consider using the related function [_snprintf](snprintf-snprintf-snprintf-l-snwprintf-snwprintf-l.md), which specifies a maximum number of characters to write to *buffer*, or use [_scprintf](scprintf-scprintf-l-scwprintf-scwprintf-l.md) to determine how large a buffer is required. Also, ensure that *format* is not a user-defined string.
95
95
96
-
**swprintf** is a wide-character version of **sprintf**; the pointer arguments to **swprintf** are wide-character strings. Detection of encoding errors in **swprintf** may differ from that in **sprintf**. **swprintf** and **fwprintf** behave identically except that **swprintf** writes output to a string rather than to a destination of type **FILE**, and **swprintf** requires the *count* parameter to specify the maximum number of characters to be written. The versions of these functions with the **_l** suffix are identical except that they use the locale parameter passed in instead of the current thread locale.
96
+
**swprintf** is a wide-character version of **sprintf**; the pointer arguments to **swprintf** are wide-character strings. Detection of encoding errors in **swprintf** may differ from **sprintf**. **swprintf** and **fwprintf** behave identically except **swprintf** writes output to a string rather than to a destination of type **FILE**, and **swprintf** requires the *count* parameter to specify the maximum number of characters to write. The versions of these functions with the **_l** suffix are identical except they use the locale parameter passed in instead of the current thread locale.
97
97
98
98
**swprintf** conforms to the ISO C Standard, which requires the second parameter, *count*, of type **size_t**. To force the old nonstandard behavior, define **_CRT_NON_CONFORMING_SWPRINTFS**. In a future version, the old behavior may be removed, so code should be changed to use the new conformant behavior.
The SafeInt library provides several functions that you can use without creating an instance of the [SafeInt class](safeint-class.md). If you want to protect a single mathematical operation from integer overflow, you can use these functions. If you want to protect multiple mathematical operations, you should create `SafeInt` objects. It is more efficient to create `SafeInt` objects than to use these functions multiple times.
11
+
The SafeInt library provides several functions that you can use without creating an instance of the [SafeInt class](safeint-class.md). If you want to protect a single mathematical operation from integer overflow, you can use these functions. If you want to protect multiple mathematical operations, you should create `SafeInt` objects. It's more efficient to create `SafeInt` objects than to use these functions multiple times.
12
12
13
13
These functions enable you to compare or perform mathematical operations on two different types of parameters without having to convert them to the same type first.
14
14
@@ -104,10 +104,10 @@ inline bool SafeDivide (
104
104
### Parameters
105
105
106
106
*t*<br/>
107
-
[in] The divisor. This must be of type T.
107
+
[in] The dividend. This must be of type T.
108
108
109
109
*u*<br/>
110
-
[in] The dividend. This must be of type U.
110
+
[in] The divisor. This must be of type U.
111
111
112
112
*result*<br/>
113
113
[out] The parameter where `SafeDivide` stores the result.
@@ -118,7 +118,7 @@ inline bool SafeDivide (
118
118
119
119
## <aname="safeequals"></a> SafeEquals
120
120
121
-
Compares two numbers to determine whether they are equal.
121
+
Compares two numbers to determine whether they're equal.
122
122
123
123
```cpp
124
124
template<typename T, typename U>
@@ -218,7 +218,7 @@ inline bool SafeLessThan (
218
218
[in] The first number. This must be of type `T`.
219
219
220
220
*u*<br/>
221
-
[in] The second numer. This must be of type `U`.
221
+
[in] The second number. This must be of type `U`.
222
222
223
223
### Return Value
224
224
@@ -314,7 +314,7 @@ inline bool SafeMultiply (
314
314
315
315
## <aname="safenotequals"></a> SafeNotEquals
316
316
317
-
Determines if two numbers are not equal.
317
+
Determines if two numbers aren't equal.
318
318
319
319
```cpp
320
320
template<typename T, typename U>
@@ -334,7 +334,7 @@ inline bool SafeNotEquals (
334
334
335
335
### Return Value
336
336
337
-
**true** if *t* and *u*are not equal; otherwise **false**.
337
+
**true** if *t* and *u*aren't equal; otherwise **false**.
0 commit comments