Preview Documents

This topic lists the available preview or pre-release documents. Since this topic is updated frequently, we recommend that you subscribe to these RSS or Atom feeds to receive update notifications.

Mt784346.image006(en-us,PROT.20).pngRSS

Mt784346.image006(en-us,PROT.20).pngAtom

The Windows Protocols documentation contains detailed technical specifications for Microsoft protocols that are implemented and used by Windows to interoperate or communicate with other Microsoft products. It also contains technical specifications for extensions to industry-standards and other published protocols that are used by Windows. In addition, the documentation includes a set of companion technology overview and reference documents that supplement the technical specifications with conceptual background, overviews of inter-protocol relationships and interactions, and technical reference information.

Documentation for released versions of Windows was last updated March 16, 2018, and is at Windows Protocols.

New Preview Documentation

Specification

Description

Preview Date

[MS-RDPECAM-Preview]:

Remote Desktop Protocol: Video Capture Virtual Channel Extension

Specifies the Remote Desktop Protocol: Video Capture Virtual Channel Extension which adds remoting of video capture devices, such as webcams, to the Basic Connectivity and Graphics Remoting Protocol.

August 2018

[MS-RDPEUDP2-Preview]: Remote Desktop Protocol: UDP Transport Extension Version 2

Specifies the Remote Desktop Protocol: UDP Transport Extension Version 2 is used to exchange data, for example audio and video, between a remote desktop client and remote desktop server over UDP transport using a URCP based rate control.

August 2018

Updated Preview Documentation

Specification

Description

Preview Date

[MS-ADFSPIP-Diff]: Active Directory Federation Services and Proxy Integration Protocol

Specifies the Active Directory Federation Services Proxy and Web Application Proxy Integration Protocol. This protocol integrates Active Directory Federation Services with an authentication and application proxy to enable access to services located inside the boundaries of the corporate network for clients that are located outside of that boundary.

This document has been updated as follows:

●  Added the signed X-MS-ProxyAuth-Token header and related fields. These are used by the proxy to pass token binding information from the Sec-Token-Binding header of the request on to the server.

●  Resolved document omissions related to AD FS behavior level and the full JSON schema.

August 2018

[MS-CDP-Diff]: Connected Devices Platform Protocol Version 3

Specifies the Connected Devices Platform Protocol Version 3. This protocol provides a discovery system to authenticate and verify users and devices, as well as providing a message exchange between devices.

This document has been updated as follows:

●  Added new message fields, value, and behavior notes.

●  Clarified the distinction between the authentication done and authentication failure messages.

August 2018

[MS-CMRP-Diff]: Failover Cluster: Management API (ClusAPI) Protocol

Specifies the Failover Cluster: Management API (ClusAPI) Protocol, an RPC-based protocol that is used for remotely managing a cluster.

This document has been updated as follows:

●  Added ApiAddGroupToGroupSetEx to the list of methods.

August 2018

[MS-CSRA-Diff]: Certificate Services Remote Administration Protocol

Specifies the Certificate Services Remote Administration Protocol, which consists of a set of Distributed Component Object Model (DCOM) interfaces that enable administrative tools to configure the state and policy of a certification authority (CA) on a server.

This document has been updated as follows:

●  Updated product behavior notes regarding new ADM elements and version related values.

●  Updated the 'Version' parameter processing rule regarding the pVariant pointer.

August 2018

[MS-FASP-Diff]: Firewall and Advanced Security Protocol

Specifies the Firewall and Advanced Security Protocol. The protocol manages firewall and advanced security components on remote computers.

This document has been updated as follows:

●  Added new policy version '0x021D' to Protocol Versions.

●  Added new dynamic port keyword enum values and descriptions for new supported services.

●  Updated definitions of the FW_TRUST_TUPLE_KEYWORD_UPNP and FW_TRUST_TUPLE_KEYWORD_WFD_CDP keyword flags in the FW_TRUST_TUPLE_KEYWORD enum.

●  Added fields 'IsDHCPClient' and 'IsPlayToDiscovery' and new fields 'IsMDNS', 'IsCortanaOut', and 'IsProximalTCPCDP' to the PortInUse ADM element.

●  Updated the abstract data model to include two new TrustTuple boolean fields and definitions.

August 2018

[MS-GPFAS-Diff]: Group Policy: Firewall and Advanced Security Data Structure

Specifies The Group Policy: Firewall and Advanced Security data structure extension, which provides a mechanism for an administrator to control the Firewall and Advanced Security behavior of the client through group policy by using the Group Policy: Registry Extension Encoding protocol [MS-GPREG].

This document has been updated as follows:

●  Updated the content describing schema versions vs operating system versions into tabular form.

●  Updated the ABNF grammar throughout the document to use dashes in place of underscores, so that rules conform with [RFC5234].

●  Added new port keyword rules to the ABNF grammar and corresponding descriptions to the definition list:

LPORT_KEYWORD_VAL_2_20 = "DHCP"

LPORT_KEYWORD_VAL_2_25 = "mDNS"

LPORT_KEYWORD_VAL_2_29 = "TcpCDPSvc"

RPORT_KEYWORD_VAL_2_28 = "CortanaOut"

●  Clarified definition list descriptions by updating the following port keyword descriptions: IPTLSIn and IPTLSOut.

●  Updated the IPHTTPSIn and IPHTTPSOut token names to match their corresponding descriptions.

August 2018

[MS-HGSA-Diff]: Host Guardian Service: Attestation Protocol

Specifies the Host Guardian Services Attestation Replaced (HGSA) protocol, one of two services that comprise the Host Guardian Service.  Host Guardian Service is a server role that provides security assurance for Shielded Virtual Machines (VMs) by ensuring that Shielded VMs can be run only on known and trusted fabric hosts that have a legitimate configuration. The other component service, the Key Protection Service, is specified in the [MS-KPS] protocol document.

This document has been updated as follows:

●  Added content on Host Key-based attestation.

●  Clarified valid AttestationResultType values.

●  Clarified details of TPM-based attestation,

AD-based attestation, and error message handling.

●  Added SecureClientList to the list of abstract data elements and the list of elements to be initialized.

August 2018

[MS-MDE2-Diff]: Mobile Device Enrollment Protocol Version 2

Specifies version 2 of the Mobile Device Enrollment Protocol (MDE), which enables enrolling a device with the DMS through an Enrollment Service (ES). The protocol includes the discovery of the Management Enrollment Service (MES) and enrollment with the ES.

This document has been updated as follows:

●  Added missing description for the EnrollmentServer subcode.

●  Added context item "OfflineAutoPilotEnrollmentCorrelator" and updated behavior note for this release of Windows.

●  Clarified the relationship between the schema listing and the Namespaces section.

August 2018

[MS-MICE-Diff]: Miracast over Infrastructure Connection Establishment Protocol

The Miracast over Infrastructure Connection Establishment Protocol specifies a connection negotiation sequence used to connect, indicate readiness to connect, and disconnect from a Miracast over Infrastructure endpoint. This protocol also specifies the Miracast over Infrastructure Information Element (IE), which helps identify Miracast receivers (sinks) that can support a Miracast session over an infrastructure link (as opposed to a Wi-Fi Direct link).

This document has been updated as follows:

●  Added support for PIN challenge and response between the Source and Sink.

August 2018

[MS-NCNBI-Diff]: Network Controller Northbound Interface

Specifies the Network Controller Protocol, which is used by tenants and network administrators to control data center networking. Common tasks that would use these APIs include designing and monitoring a virtual network in a data center.

This document has been updated as follows:

●  Added protocol version 3 content with a product note version table.

●  Added auditingSettings resource for protocol v3.

●  Removed bgpNetworks, changed routerIPAddress to routerIP.

●  Added protocol v3 virtualNetworkPeerings resource.

●  Added new section Resource Counters, protocol version 3, content for these versions of Windows Server.

●  Added protocol v3 resources auditingSettings, discovery, and virtualNetworkPeerings.

●  Added url and resourceId descriptions, counters properties and a protocol version note.

●  Added isEnabled and requireIGPSync properties to property table. Changed routerIPAddress to routerIP.

August 2018

[MS-OAPX-Diff]: OAuth 2.0 Protocol Extensions

Specifies the OAuth 2.0 Protocol Extensions, which are used to extend the OAuth 2.0 Authorization Framework. These extensions enable authorization features such as resource specification, request identifiers, and login hints.

This document has been updated as follows:

●  Added the device authorization endpoint (/devicecode) and all supporting structures and definitions. This endpoint is used by an OAuth 2.0 client to obtain device verification codes, user codes, and verification URLs.

●  Added AD_FS_BEHAVIOR_LEVEL_4 (value of 4) as the next AD FS behavior level.

●  Specified the numeric values for the AD_FS_BEHAVIOR_LEVEL constants.

●  Added information about the support for the mfa_max_age parameter that was added through KB 4088889.

●  Added support information for AD_FS_BEHAVIOR_LEVEL_3.

August 2018

[MS-OIDCE-Diff]: OpenID Connect 1.0 Protocol Extensions

Specifies the OpenID Connect 1.0 Protocol Extensions. These extensions define additional claims to carry information about the end user, including the user principal name, a locally unique identifier, a time for password expiration, and a URL for password change. These extensions also define additional provider metadata that enable the discovery of the issuer of access tokens and give additional information about provider capabilities.

This document has been updated as follows:

●  Added support for the device authorization endpoint (/devicecode), which is used by an OAuth 2.0 client to obtain device verification codes, user codes, and verification URLs.

August 2018

[MS-RDPBCGR-Diff]: Remote Desktop Protocol: Basic Connectivity and Graphics Remoting

Specifies the Remote Desktop Protocol: Basic Connectivity and Graphics Remoting, designed to facilitate user interaction with a remote computer system by transferring graphics display information from the remote computer to the user and transporting input from the user to the remote computer, where it may be injected locally.

This document has been updated as follows:

●  Updated version number table:

Added 0x0008000B for RDP 10.6 clients

Added 0x0008000B for RDP 10.6 servers

●  Revised description of error code ERRINFO_BADMONITORDATA for clarification.  Updated errorInfo table to add 3 new error codes: ERRINFO_VIRTUALDESKTOPTOOLARGE, ERRINFO_MONITORGEOMETRYVALIDATIONFAILED, ERRINFO_INVALIDMONITORCOUNT.

●  Updated to indicate supported RDP versions.

●  Updated description of TargetCertificate field to specify Unicode format.

●  Updated source descriptor field.

August 2018

[MS-RDPEGFX-Diff]: Remote Desktop Protocol: Graphics Pipeline Extension

Specifies the Remote Desktop Protocol: Graphics Pipeline Extension, a graphics protocol that is used to encode graphics display data generated in a remote terminal server session so that the data can be sent from the server and received, decoded, and rendered by a compatible client. The net effect is that a desktop or an application running on a remote terminal server appears as if it is running locally.

This document has been updated as follows:

●  Updated to add RPDGFX_CAPSET_VERSION106 structure.

●  Updated to include new structure, RDPGFX_CAPVERSION_106.

●  Added a new section that describes the structure that specifies an RDP version 10.6 Graphics Capability Set.

●  Clarified how AVC444/AVC444v2 is encoded and decoded.

●  Removed limitation from capsSet field.

●  Added the CAPSET versions 104 and 105 to flags field list.

August 2018

[MS-RDPERP-Diff]: Remote Desktop Protocol: Remote Programs Virtual Channel Extension

Specifies the Remote Desktop Protocol: Remote Programs Virtual Channel Extension, an RDP feature that presents a remote application (running remotely on a RAIL server) as a local user application (running on the RAIL client machine).

This document has been updated as follows:

●  Added the TS_RAIL_CLIENTSTATUS_BIDIRECTIONAL_CLOAK_SUPPORTED value to the Flags field table.

●  Updated the WindowId field description and described the client and server behavior when the window is in a cloaked state.

●  Added the Processing Window Cloak State Change PDU sync message.

●  Clarified when the server must not send a Window Cloak State Change PDU back to the client.

●  Added the Sending Window Cloak State Change PDU sync message.

August 2018

[MS-RDPEUDP-Diff]: Remote Desktop Protocol: UDP Transport Extension

Specifies the Remote Desktop Protocol: UDP Transport Extension, which extends the transport mechanisms in the Remote Desktop Protocol (RDP) to enable network connectivity between the user's machine and a remote computer system over the User Datagram Protocol (UDP).

This document has been updated as follows:

●  Updated to clarify when the UDP data transfer messages are applicable.

●  Updated to include protocol version 3.

●  Updated the uUdpVer field table to include protocol version 3.

●  Clarified applicability of the data transfer phase.

August 2018

Show: