more human edits

Author: gewarren

docs/core/unmanaged-api/hosting/createdebugginginterfacefromversion-function.md

@@ -18,7 +18,7 @@ topic_type:
 ---
 # CreateDebuggingInterfaceFromVersion Function (.NET Framework)
 
-Creates an [ICorDebug](../../../framework/debuggingicordebug-interface.md) object based on the specified version information.
+Creates an [ICorDebug](../../../framework/debugging/icordebug-interface.md) object based on the specified version information.
 
  This function is obsolete in the .NET Framework 4. Instead, to get an interface for the common language runtime (CLR) 2.0, use the [ICLRRuntimeInfo::GetInterface](iclrruntimeinfo-getinterface-method.md) method and specify the class identifier CLSID_CLRDebuggingLegacy and the interface identifier IID_ICorDebug. To get an interface for CLR 4 or later, call the [CLRCreateInstance](clrcreateinstance-function.md) function and specify the class identifier CLSID_CLRDebugging and the interface identifier IID_ICLRDebugging.
 
@@ -35,7 +35,7 @@ HRESULT CreateDebuggingInterfaceFromVersion (
 ## Parameters
 
  `iDebuggerVersion`\
- [in] The version of `ICorDebug` that is expected by the debugger. See the [CorDebugInterfaceVersion](../../../framework/debuggingcordebuginterfaceversion-enumeration.md) enumeration for valid values.
+ [in] The version of `ICorDebug` that is expected by the debugger. See the [CorDebugInterfaceVersion](../../../framework/debugging/cordebuginterfaceversion-enumeration.md) enumeration for valid values.
 
  `szDebuggeeVersion`\
  [in] The common language runtime version associated with the application or process to be debugged. See the [GetVersionFromProcess](getversionfromprocess-function.md) or [GetRequestedRuntimeVersion](getrequestedruntimeversion-function.md) method for information on retrieving this value.

docs/core/unmanaged-api/hosting/deprecated-clr-hosting-functions.md

@@ -2,17 +2,12 @@
 description: "Learn more about: Deprecated CLR Hosting Functions"
 title: "Deprecated CLR Hosting Functions"
 ms.date: "03/30/2017"
-helpviewer_keywords:
-  - ".NET Framework 1.1, hosting global static functions"
-  - "global static functions [.NET Framework hosting], version 2.0"
-  - ".NET Framework 2.0, hosting global static functions"
-  - "hosting global static functions [.NET Framework], version 2.0"
 ---
 # Deprecated CLR Hosting Functions
 
 This section describes the unmanaged global static functions that earlier versions of the hosting API used.
 
- With the exception of the infrastructure functions (`_Cor*` functions), which are used only by the .NET Framework, these functions have been deprecated in the .NET Framework 4.
+ With the exception of the infrastructure functions (`_Cor*` functions), which are used only by .NET Framework, these functions are deprecated starting in .NET Framework 4.
 
 ## Activation functions
 
@@ -98,7 +93,7 @@ This section describes the unmanaged global static functions that earlier versio
  Obsolete.
 
  [CreateDebuggingInterfaceFromVersion Function](createdebugginginterfacefromversion-function.md)
- Deprecated. Creates an [ICorDebug](../../../framework/debuggingicordebug-interface.md) object based on the specified version information.
+ Deprecated. Creates an [ICorDebug](../../../framework/debugging/icordebug-interface.md) object based on the specified version information.
 
  [CreateICeeFileGen Function](createiceefilegen-function.md)
  Deprecated. Creates an [ICeeFileGen](iceefilegen-class.md) object.

docs/core/unmanaged-api/hosting/index.md

@@ -11,6 +11,8 @@ helpviewer_keywords:
 
 The hosting API enables unmanaged hosts to integrate the common language runtime (CLR) into their applications.
 
+These APIs that can be used with both .NET Framework and .NET.
+
 ## In This Section
 
  [Hosting Coclasses](hosting-coclasses.md)\

docs/core/unmanaged-api/metadata/imetadataassemblyimport-findassembliesbyname-method.md

@@ -62,7 +62,7 @@ HRESULT FindAssembliesByName (
 
 ## Remarks
 
- Given an assembly name, the `FindAssembliesByName` method finds the assembly by following the standard rules for resolving assembly references. (For more information, see [How the Runtime Locates Assemblies](../../deployment/how-the-runtime-locates-assemblies.md).) `FindAssembliesByName` allows the caller to configure various aspects of the assembly resolver context, such as application base and private search path.
+ Given an assembly name, the `FindAssembliesByName` method finds the assembly by following the standard rules for resolving assembly references. (For more information, see [How the Runtime Locates Assemblies](../../../framework/deployment/how-the-runtime-locates-assemblies.md).) `FindAssembliesByName` allows the caller to configure various aspects of the assembly resolver context, such as application base and private search path.
 
  The `FindAssembliesByName` method requires the CLR to be initialized in the process in order to invoke the assembly resolution logic. Therefore, you must call [CoInitializeEE](../hosting/coinitializeee-function.md) (passing COINITEE_DEFAULT) before calling `FindAssembliesByName`, and then follow with a call to [CoUninitializeCor](../hosting/couninitializecor-function.md).
 
@@ -82,5 +82,5 @@ HRESULT FindAssembliesByName (
 
 ## See also
 
-- [How the Runtime Locates Assemblies](../../deployment/how-the-runtime-locates-assemblies.md)
+- [How the Runtime Locates Assemblies](../../../framework/deployment/how-the-runtime-locates-assemblies.md)
 - [IMetaDataAssemblyImport Interface](imetadataassemblyimport-interface.md)

docs/core/unmanaged-api/metadata/imetadataassemblyimport-findexportedtypebyname-method.md

@@ -58,4 +58,4 @@ HRESULT FindExportedTypeByName (
 ## See also
 
 - [IMetaDataAssemblyImport Interface](imetadataassemblyimport-interface.md)
-- [How the Runtime Locates Assemblies](../../deployment/how-the-runtime-locates-assemblies.md)
+- [How the Runtime Locates Assemblies](../../../framework/deployment/how-the-runtime-locates-assemblies.md)

docs/core/unmanaged-api/metadata/imetadataassemblyimport-findmanifestresourcebyname-method.md

@@ -54,4 +54,4 @@ HRESULT FindManifestResourceByName (
 ## See also
 
 - [IMetaDataAssemblyImport Interface](imetadataassemblyimport-interface.md)
-- [How the Runtime Locates Assemblies](../../deployment/how-the-runtime-locates-assemblies.md)
+- [How the Runtime Locates Assemblies](../../../framework/deployment/how-the-runtime-locates-assemblies.md)

docs/core/unmanaged-api/metadata/index.md

@@ -11,21 +11,21 @@ helpviewer_keywords:
 
 The metadata API enables a client, such as a compiler, to generate or access a component's metadata without the types being loaded by the common language runtime (CLR).
 
-These articles describe APIs that can be used with both .NET Framework and .NET. For .NET Framework-specific unmanaged APIs, see [.NET Framework metadata](../../../framework/unmanaged-api/metadata/index.md).
+These APIs that can be used with both .NET Framework and .NET.
 
-## In This Section
+## In this section
 
- [Metadata Interfaces](metadata-interfaces.md)
- Describes the unmanaged interfaces that provide access to the metadata exposed by the .NET types, methods, fields, and so on.
+[Metadata Interfaces](metadata-interfaces.md)\
+Describes the unmanaged interfaces that provide access to the metadata exposed by the .NET types, methods, fields, and so on.
 
- [Metadata Global Static Functions](metadata-global-static-functions.md)
- Describes the unmanaged global static functions that the metadata API uses.
+[Metadata Global Static Functions](metadata-global-static-functions.md)\
+Describes the unmanaged global static functions that the metadata API uses.
 
- [Metadata Enumerations](metadata-enumerations.md)
- Describes the unmanaged enumerations that the metadata API uses.
+[Metadata Enumerations](metadata-enumerations.md)\
+Describes the unmanaged enumerations that the metadata API uses.
 
- [Metadata Structures](metadata-structures.md)
- Describes the unmanaged structures that the metadata API uses.
+[Metadata Structures](metadata-structures.md)\
+Describes the unmanaged structures that the metadata API uses.
 
- [Metadata Unions](metadata-unions.md)
- Describes the unmanaged unions that the metadata API uses.
+[Metadata Unions](metadata-unions.md)\
+Describes the unmanaged unions that the metadata API uses.

docs/framework/unmanaged-api/alink/addfile-method.md

@@ -35,19 +35,19 @@ HRESULT AddFile(
 
 ## Parameters
 
- `AssemblyID`
+ `AssemblyID`\
  Unique ID of the assembly to be augmented.
 
- `pszFilename`
+ `pszFilename`\
  Fully qualified name of file to be added.
 
- `dwFlags`
- COM+ FileDef flags such as `ffContainsNoMetaData` and `ffWriteable`. `dwFlags` is passed to [DefineFile Method](../../../core/unmanaged-apis/metadata/imetadataassemblyemit-definefile-method.md).
+ `dwFlags`\
+ COM+ FileDef flags such as `ffContainsNoMetaData` and `ffWriteable`. `dwFlags` is passed to [DefineFile Method](../../../core/unmanaged-api/metadata/imetadataassemblyemit-definefile-method.md).
 
- `pEmitter`
- [IMetaDataEmit Interface](../../../core/unmanaged-apis/metadata/imetadataemit-interface.md) interface to be used to emit metadata, if necessary.
+ `pEmitter`\
+ [IMetaDataEmit Interface](../../../core/unmanaged-api/metadata/imetadataemit-interface.md) interface to be used to emit metadata, if necessary.
 
- `pFileToken`
+ `pFileToken`\
  Pointer to where the unique ID of the added file will be stored.
 
 ## Return Value

docs/framework/unmanaged-api/alink/addfile2-method.md

@@ -42,10 +42,10 @@ HRESULT AddFile2(
  Name of the file to be added.
 
  `dwFlags`
- COM+ `FileDef` flags such as `ffContainsNoMetaData` and `ffWriteable`. `dwFlags` is passed to [DefineFile Method](../../../core/unmanaged-apis/metadata/imetadataassemblyemit-definefile-method.md).
+ COM+ `FileDef` flags such as `ffContainsNoMetaData` and `ffWriteable`. `dwFlags` is passed to [DefineFile Method](../../../core/unmanaged-api/metadata/imetadataassemblyemit-definefile-method.md).
 
  `pEmitter`
- Interface to [IMetaDataEmit2 Interface](../../../core/unmanaged-apis/metadata/imetadataemit2-interface.md) interface.
+ Interface to [IMetaDataEmit2 Interface](../../../core/unmanaged-api/metadata/imetadataemit2-interface.md) interface.
 
  `pFileToken`
  Receives ID for the file being added.

docs/framework/unmanaged-api/alink/addimport-method.md

@@ -41,7 +41,7 @@ HRESULT AddImport(
  Unique ID, retrieved from [ImportFile Method](importfile-method.md), of file to be imported.
 
  `dwFlags`
- COM+ FileDef flags such as `ffContainsNoMetaData` and `ffWriteable`. `dwFlags` is passed to [DefineFile Method](../../../core/unmanaged-apis/metadata/imetadataassemblyemit-definefile-method.md).
+ COM+ FileDef flags such as `ffContainsNoMetaData` and `ffWriteable`. `dwFlags` is passed to [DefineFile Method](../../../core/unmanaged-api/metadata/imetadataassemblyemit-definefile-method.md).
 
  `pFileToken`
  Pointer to token that receives the ID for the resulting file.

docs/framework/unmanaged-api/alink/embedresource-method.md

@@ -48,7 +48,7 @@ HRESULT EmbedResource(
  Offset of resource from RVA.
 
  `dwFlags`
- Accessibility flags such as `mrPublic` and `mrPrivate`. These flags may be passed to [DefineExportedType Method](../../../core/unmanaged-apis/metadata/imetadataassemblyemit-defineexportedtype-method.md).
+ Accessibility flags such as `mrPublic` and `mrPrivate`. These flags may be passed to [DefineExportedType Method](../../../core/unmanaged-api/metadata/imetadataassemblyemit-defineexportedtype-method.md).
 
 ## Return Value
 

docs/framework/unmanaged-api/alink/exportnestedtype-method.md

@@ -53,7 +53,7 @@ HRESULT ExportNestedType(
  Fully qualified type name to export.
 
  `dwFlags`
- `ComType` flags such as `tdPublic` or `tdNested`. This value may be passed to [DefineExportedType Method](../../../core/unmanaged-apis/metadata/imetadataassemblyemit-defineexportedtype-method.md).
+ `ComType` flags such as `tdPublic` or `tdNested`. This value may be passed to [DefineExportedType Method](../../../core/unmanaged-api/metadata/imetadataassemblyemit-defineexportedtype-method.md).
 
  `pType`
  Receives token for exported type.

docs/framework/unmanaged-api/alink/exporttype-method.md

@@ -48,7 +48,7 @@ HRESULT ExportType(
  Fully qualified type name to be made exportable.
 
  `dwFlags`
- `ComType` flags such as `tdPublic` or `tdNested`. This parameter may be passed to [DefineExportedType Method](../../../core/unmanaged-apis/metadata/imetadataassemblyemit-defineexportedtype-method.md).
+ `ComType` flags such as `tdPublic` or `tdNested`. This parameter may be passed to [DefineExportedType Method](../../../core/unmanaged-api/metadata/imetadataassemblyemit-defineexportedtype-method.md).
 
  `pType`
  Receives token for exported type.

docs/framework/unmanaged-api/alink/exporttypeforwarder-method.md

@@ -40,7 +40,7 @@ HRESULT ExportTypeForwarder(
  Fully qualified type name to export.
 
  `dwFlags`
- `ComType` flags such as `tdPublic` or `tdNested`. This value may be passed to [DefineExportedType Method](../../../core/unmanaged-apis/metadata/imetadataassemblyemit-defineexportedtype-method.md).
+ `ComType` flags such as `tdPublic` or `tdNested`. This value may be passed to [DefineExportedType Method](../../../core/unmanaged-api/metadata/imetadataassemblyemit-defineexportedtype-method.md).
 
  `pType`
  Receives the token of the exported type. This is necessary only for emitting nested types.

docs/framework/unmanaged-api/alink/getscope-method.md

@@ -43,7 +43,7 @@ HRESULT GetScope(
  Zero-based scope to import.
 
  `ppImportScope`
- Receives [IMetaDataImport Interface](../../../core/unmanaged-apis/metadata/imetadataimport-interface.md) interface for the scope.
+ Receives [IMetaDataImport Interface](../../../core/unmanaged-api/metadata/imetadataimport-interface.md) interface for the scope.
 
 ## Return Value
 

docs/framework/unmanaged-api/alink/getscope2-method.md

@@ -43,7 +43,7 @@ HRESULT GetScope2(
  Zero-based scope to import.
 
  `ppImportScope`
- Receives pointer to [IMetaDataImport2 Interface](../../../core/unmanaged-apis/metadata/imetadataimport2-interface.md) interface for indicated scope.
+ Receives pointer to [IMetaDataImport2 Interface](../../../core/unmanaged-api/metadata/imetadataimport2-interface.md) interface for indicated scope.
 
 ## Return Value
 

docs/framework/unmanaged-api/alink/ialink2-interface.md

@@ -10,7 +10,7 @@ ms.assetid: fba62a55-36bd-401e-bcd2-5be8e2d34891
 ---
 # IALink2 Interface
 
-Complements the [IALink Interface](ialink-interface.md) by declaring methods that operate on newer metadata interfaces such as [IMetaDataEmit2 Interface](../../../core/unmanaged-apis/metadata/imetadataemit2-interface.md). Additionally, IALink2 declares methods that provide additional usage flexibility over the original IALink interfaces.
+Complements the [IALink Interface](ialink-interface.md) by declaring methods that operate on newer metadata interfaces such as [IMetaDataEmit2 Interface](../../../core/unmanaged-api/metadata/imetadataemit2-interface.md). Additionally, IALink2 declares methods that provide additional usage flexibility over the original IALink interfaces.
 
 ## In This Section
 

docs/framework/unmanaged-api/alink/importfile-method.md

@@ -48,7 +48,7 @@ HRESULT ImportFile(
  Pointer to token where a unique file ID will be stored. The file can be an assembly or a file.
 
  `ppAssemblyScope`
- Receives pointer to [IMetaDataAssemblyImport Interface](../../../core/unmanaged-apis/metadata/imetadataassemblyimport-interface.md). Can be NULL if the file is not an assembly.
+ Receives pointer to [IMetaDataAssemblyImport Interface](../../../core/unmanaged-api/metadata/imetadataassemblyimport-interface.md). Can be NULL if the file is not an assembly.
 
  `pdwCountOfScopes`
  Pointer to the count of files and/or scopes that have been imported.

docs/framework/unmanaged-api/alink/importfile2-method.md

@@ -43,7 +43,7 @@ HRESULT ImportFile2(
  Optional output file name that can be used to rename the file as it is linked into the assembly.
 
  `pAssemblyScopeIn`
- Optional scope [IMetaDataAssemblyImport Interface](../../../core/unmanaged-apis/metadata/imetadataassemblyimport-interface.md) interface.
+ Optional scope [IMetaDataAssemblyImport Interface](../../../core/unmanaged-api/metadata/imetadataassemblyimport-interface.md) interface.
 
  `fSmartImport`
  If TRUE, ImportTypes is used, otherwise importing must be performed manually.
@@ -52,7 +52,7 @@ HRESULT ImportFile2(
  Receives the ID for the file or assembly.
 
  `ppAssemblyScope`
- Receives the [IMetaDataAssemblyImport Interface](../../../core/unmanaged-apis/metadata/imetadataassemblyimport-interface.md) interface. NULL if the file is not an assembly.
+ Receives the [IMetaDataAssemblyImport Interface](../../../core/unmanaged-api/metadata/imetadataassemblyimport-interface.md) interface. NULL if the file is not an assembly.
 
  `pdwCountOfScopes`
  Receives the found of files and/or scopes imported.

docs/framework/unmanaged-api/alink/importfileex-method.md

@@ -46,13 +46,13 @@ HRESULT ImportFileEx(
  If TRUE, ImportTypes is used, otherwise importing must be performed manually.
 
  `dwOpenFlags`
- Flags to be passed along to [OpenScope Method](../../../core/unmanaged-apis/metadata/imetadatadispenser-openscope-method.md).
+ Flags to be passed along to [OpenScope Method](../../../core/unmanaged-api/metadata/imetadatadispenser-openscope-method.md).
 
  `pImportToken`
  Receives ID of the file being imported.
 
  `ppAssemblyScope`
- Receives assembly import scope [IMetaDataAssemblyImport Interface](../../../core/unmanaged-apis/metadata/imetadataassemblyimport-interface.md) interface. Is set to NULL if file is not an assembly.
+ Receives assembly import scope [IMetaDataAssemblyImport Interface](../../../core/unmanaged-api/metadata/imetadataassemblyimport-interface.md) interface. Is set to NULL if file is not an assembly.
 
  `pdwCountOfScopes`
  Receives count of imported files and/or scopes.

docs/framework/unmanaged-api/alink/importfileex2-method.md

@@ -44,19 +44,19 @@ HRESULT ImportFileEx2(
  Optional name of target file.
 
  `pAssemblyScopeIn`
- Optional import scope [IMetaDataAssemblyImport Interface](../../../core/unmanaged-apis/metadata/imetadataassemblyimport-interface.md) interface.
+ Optional import scope [IMetaDataAssemblyImport Interface](../../../core/unmanaged-api/metadata/imetadataassemblyimport-interface.md) interface.
 
  `fSmartImport`
  If TRUE, ImportTypes is used, otherwise importing must be performed manually.
 
  `dwOpenFlags`
- Flags to be passed along to [OpenScope Method](../../../core/unmanaged-apis/metadata/imetadatadispenser-openscope-method.md).
+ Flags to be passed along to [OpenScope Method](../../../core/unmanaged-api/metadata/imetadatadispenser-openscope-method.md).
 
  `pImportToken`
  Receives unique ID for the assembly or file.
 
  `ppAssemblyScope`
- Receives assembly import scope [IMetaDataAssemblyImport Interface](../../../core/unmanaged-apis/metadata/imetadataassemblyimport-interface.md) interface. Can be NULL if the file is not an assembly.
+ Receives assembly import scope [IMetaDataAssemblyImport Interface](../../../core/unmanaged-api/metadata/imetadataassemblyimport-interface.md) interface. Can be NULL if the file is not an assembly.
 
  `pdwCountOfScopes`
  Receives the number of files and/or scopes imported.

docs/framework/unmanaged-api/alink/importtypes-method.md

@@ -48,7 +48,7 @@ HRESULT ImportTypes(
  Receives enumerator handle for the types in this scope.
 
  `ppImportScope`
- Optionally receives [IMetaDataImport Interface](../../../core/unmanaged-apis/metadata/imetadataimport-interface.md) interface.
+ Optionally receives [IMetaDataImport Interface](../../../core/unmanaged-api/metadata/imetadataimport-interface.md) interface.
 
  `pdwCountOfTypes`
  Optionally receives count of types in the indicated scope.

docs/framework/unmanaged-api/alink/importtypes2-method.md

@@ -48,7 +48,7 @@ HRESULT ImportTypes2(
  Receives enumerator handle for the types in the given scope.
 
  `ppImportScope`
- Optionally receives [IMetaDataImport2 Interface](../../../core/unmanaged-apis/metadata/imetadataimport2-interface.md) interface.
+ Optionally receives [IMetaDataImport2 Interface](../../../core/unmanaged-api/metadata/imetadataimport2-interface.md) interface.
 
  `pdwCountOfTypes`
  Optionally receives count of types in the specified scope.

docs/framework/unmanaged-api/alink/init-method.md

@@ -32,10 +32,10 @@ HRESULT Init(
 ## Parameters
 
  `pDispenser`
- [IMetaDataDispenserEx Interface](../../../core/unmanaged-apis/metadata/imetadatadispenserex-interface.md) pointer to the metadata dispenser.
+ [IMetaDataDispenserEx Interface](../../../core/unmanaged-api/metadata/imetadatadispenserex-interface.md) pointer to the metadata dispenser.
 
  `pErrorHandler`
- [IMetaDataError Interface](../../../core/unmanaged-apis/metadata/imetadataerror-interface.md) pointer to an optional error handling interface.
+ [IMetaDataError Interface](../../../core/unmanaged-api/metadata/imetadataerror-interface.md) pointer to an optional error handling interface.
 
 ## Return Value
 

docs/framework/unmanaged-api/alink/linkresource-method.md

@@ -47,7 +47,7 @@ HRESULT LinkResource(
  Name of the resource.
 
  `dwFlags`
- Accessibility flags such as `mrPublic` and `mrPrivate`. This parameter may be passed to [DefineManifestResource Method](../../../core/unmanaged-apis/metadata/imetadataassemblyemit-definemanifestresource-method.md).
+ Accessibility flags such as `mrPublic` and `mrPrivate`. This parameter may be passed to [DefineManifestResource Method](../../../core/unmanaged-api/metadata/imetadataassemblyemit-definemanifestresource-method.md).
 
 ## Return Value