Merge pull request #2914 from TylerMSFT/twhitney-githubissues

TylerMSFT · web-flow · commit cd999d55c8dc · 2020-05-28T18:57:23.000-07:00
Better example and small acrolinx fixes
diff --git a/docs/mfc/reference/cftpfilefind-class.md b/docs/mfc/reference/cftpfilefind-class.md
@@ -27,15 +27,15 @@ class CFtpFileFind : public CFileFind
 
 |Name|Description|
 |----------|-----------------|
-|[CFtpFileFind::FindFile](#findfile)|Finds a file on a FTP server.|
+|[CFtpFileFind::FindFile](#findfile)|Finds a file on an FTP server.|
 |[CFtpFileFind::FindNextFile](#findnextfile)|Continues a file search from a previous call to [FindFile](#findfile).|
 |[CFtpFileFind::GetFileURL](#getfileurl)|Gets the URL, including path, of the found file.|
 
 ## Remarks
 
 `CFtpFileFind` includes member functions that begin a search, locate a file, and return the URL or other descriptive information about the file.
 
-Other MFC classes designed for Internet and local file searched include [CGopherFileFind](../../mfc/reference/cgopherfilefind-class.md) and [CFileFind](../../mfc/reference/cfilefind-class.md). Together with `CFtpFileFind`, these classes provide a seamless mechanism for the client to find specific files, regardless of the server protocol or file type (either a local machine or a remote server). Note that there is no MFC class for searching on HTTP servers because HTTP does not support the direct file manipulation required for searches.
+Other MFC classes designed for Internet and local file searched include [CGopherFileFind](../../mfc/reference/cgopherfilefind-class.md) and [CFileFind](../../mfc/reference/cfilefind-class.md). Together with `CFtpFileFind`, these classes provide a seamless mechanism for the client to find specific files, regardless of the server protocol or file type (either a local machine or a remote server). There's no MFC class for searching on HTTP servers because HTTP doesn't support the direct file manipulation required for searches.
 
 For more information about how to use `CFtpFileFind` and the other WinInet classes, see the article [Internet Programming with WinInet](../../mfc/win32-internet-extensions-wininet.md).
 
@@ -73,11 +73,11 @@ explicit CFtpFileFind(
 A pointer to a `CFtpConnection` object. You can obtain an FTP connection by calling [CInternetSession::GetFtpConnection](../../mfc/reference/cinternetsession-class.md#getftpconnection).
 
 *dwContext*<br/>
-The context identifier for the `CFtpFileFind` object. See **Remarks** for more information about this parameter.
+The context identifier for the `CFtpFileFind` object. For more information, see the following **remarks**.
 
 ### Remarks
 
-The default value for *dwContext* is sent by MFC to the `CFtpFileFind` object from the [CInternetSession](../../mfc/reference/cinternetsession-class.md) object that created the `CFtpFileFind` object. You can override the default to set the context identifier to a value of your choosing. The context identifier is returned to [CInternetSession::OnStatusCallback](../../mfc/reference/cinternetsession-class.md#onstatuscallback) to provide status on the object with which it is identified. See the article [Internet First Steps: WinInet](../../mfc/wininet-basics.md) for more information about the context identifier.
+The default value for *dwContext* is sent by MFC to the `CFtpFileFind` object from the [CInternetSession](../../mfc/reference/cinternetsession-class.md) object that created the `CFtpFileFind` object. You can override the default to set the context identifier to a value of your choosing. The context identifier is returned to [CInternetSession::OnStatusCallback](../../mfc/reference/cinternetsession-class.md#onstatuscallback) to provide status on the object with which it's identified. See the article [Internet First Steps: WinInet](../../mfc/wininet-basics.md) for more information about the context identifier.
 
 ### Example
 
@@ -96,20 +96,20 @@ virtual BOOL FindFile(
 ### Parameters
 
 *pstrName*<br/>
-A pointer to a string containing the name of the file to find. If NULL, the call will perform a wildcard search (*).
+A pointer to a string containing the name of the file to find. If NULL, the call will do a wildcard search (*).
 
 *dwFlags*<br/>
 The flags describing how to handle this session. These flags can be combined with the bitwise OR operator (&#124;) and are as follows:
 
-- INTERNET_FLAG_RELOAD   Get the data from the wire even if it is locally cached. This is the default flag.
+- `INTERNET_FLAG_RELOAD`   Get the data from the wire even if it's locally cached. This is the default flag.
 
-- INTERNET_FLAG_DONT_CACHE   Do not cache the data, either locally or in any gateways.
+- `INTERNET_FLAG_DONT_CACHE`   Don't cache the data, either locally or in any gateways.
 
-- INTERNET_FLAG_RAW_DATA   Override the default to return the raw data ( [WIN32_FIND_DATA](/windows/win32/api/minwinbase/ns-minwinbase-win32_find_dataw) structures for FTP).
+- `INTERNET_FLAG_RAW_DATA`   Override the default to return the raw data ( [WIN32_FIND_DATA](/windows/win32/api/minwinbase/ns-minwinbase-win32_find_dataw) structures for FTP).
 
-- INTERNET_FLAG_SECURE   Secures transactions on the wire with Secure Sockets Layer or PCT. This flag is applicable to HTTP requests only.
+- `INTERNET_FLAG_SECURE`   Secures transactions on the wire with Secure Sockets Layer or PCT. This flag applies to HTTP requests only.
 
-- INTERNET_FLAG_EXISTING_CONNECT   If possible, reuse the existing connections to the server for new `FindFile` requests instead of creating a new session for each request.
+- `INTERNET_FLAG_EXISTING_CONNECT`   If possible, reuse the existing connections to the server for new `FindFile` requests instead of creating a new session for each request.
 
 ### Return Value
 
@@ -159,7 +159,7 @@ The file and path of the Universal Resource Locator (URL).
 
 ### Remarks
 
-`GetFileURL` is similar to the member function [CFileFind::GetFilePath](../../mfc/reference/cfilefind-class.md#getfilepath), except that in addition to providing the result in URL format, it doesn't include the filename. For example:`ftp://moose/dir`.
+`GetFileURL` is similar to the member function [CFileFind::GetFilePath](../../mfc/reference/cfilefind-class.md#getfilepath) except that it provides the result in URL format. As with `CFileFind::GetFilePath`, the result doesn't include the filename. For example, `file1.txt` located in `//moose/dir/file1.txt:` returns `ftp://moose/dir/`.
 
 ## See also
 
diff --git a/docs/windows/walkthrough-creating-windows-desktop-applications-cpp.md b/docs/windows/walkthrough-creating-windows-desktop-applications-cpp.md
@@ -354,7 +354,7 @@ Next, you'll learn how to create the code for a Windows desktop application in V
 
    One important message to handle is the [WM_PAINT](/windows/win32/gdi/wm-paint) message. The application receives the `WM_PAINT` message when part of its displayed window must be updated. The event can occur when a user moves a window in front of your window, then moves it away again. Your application doesn't know when these events occur. Only Windows knows, so it notifies your app with a `WM_PAINT` message. When the window is first displayed, all of it must be updated.
 
-   To handle a `WM_PAINT` message, first call [BeginPaint](/windows/win32/api/winuser/nf-winuser-beginpaint), then handle all the logic to layout the text, buttons, and other controls in the window, and then call [EndPaint](/windows/win32/api/winuser/nf-winuser-endpaint). For the application, the logic between the beginning call and the ending call displays the string "Hello, Windows desktop!" in the window. In the following code, the [TextOut](/windows/win32/api/wingdi/nf-wingdi-textoutw) function is used to display the string.
+   To handle a `WM_PAINT` message, first call [BeginPaint](/windows/win32/api/winuser/nf-winuser-beginpaint), then handle all the logic to lay out the text, buttons, and other controls in the window, and then call [EndPaint](/windows/win32/api/winuser/nf-winuser-endpaint). For the application, the logic between the beginning call and the ending call displays the string "Hello, Windows desktop!" in the window. In the following code, the [TextOut](/windows/win32/api/wingdi/nf-wingdi-textoutw) function is used to display the string.
 
    ```cpp
    PAINTSTRUCT ps;
@@ -379,8 +379,8 @@ Next, you'll learn how to create the code for a Windows desktop application in V
    }
    ```
 
-   `HDC` in the code is a handle to a device context, which is a data structure used to communicate with the graphics subsystem about the window. Calling `BeginPaint` and `EndPaint` tells the graphics subsystem that you are updating the invalidated region and that no more painting is required until it is invalidated again. Otherwise, you will keep getting WM_PAINT messages for that region.
-
+   `HDC` in the code is a handle to a device context, which is used to draw in the window's client area. Use the `BeginPaint` and `EndPaint` functions to prepare for and complete the drawing in the client area. `BeginPaint` returns a handle to the display device context used for drawing in the client area; `EndPaint` ends the paint request and releases the device context.
+   
 1. An application typically handles many other messages. For example, [WM_CREATE](/windows/win32/winmsg/wm-create) when a window is first created, and [WM_DESTROY](/windows/win32/winmsg/wm-destroy) when the window is closed. The following code shows a basic but complete `WndProc` function.
 
    ```cpp
