Microsoft.AspNetCore.Server.IIS Reads data from the Input pipe to the user. Writes data to the output pipe. Flushes the data in the output pipe The default authentication handler with IIS In-Process A which throws on calls to write after the stream was upgraded Users should not need to instantiate this class. A which only allows for writes. Extensions to that enable access to IIS features. Gets the value of a server variable for the current request. The http context for the request. The name of the variable. null if the server does not support the feature. May return null or empty if the variable does not exist or is not set. This feature provides access to IIS application information Gets the version of IIS that is being used. Gets the AppPool name that is currently running Gets the path to the AppPool config Gets path to the application configuration that is currently running Gets the physical path of the application. Gets the virtual path of the application. Gets ID of the current application. Gets the name of the current site. Gets the id of the current site. String constants used to configure IIS In-Process. Default authentication scheme, which is "Windows". Cannot write to response body after connection has been upgraded. The response has been aborted due to an unhandled application exception. Cannot upgrade a non-upgradable request. Check IHttpUpgradeFeature.IsUpgradableRequest to determine if a request can be upgraded. IHttpUpgradeFeature.UpgradeAsync was already called and can only be called once per connection. Synchronous operations are disallowed. Call ReadAsync or set AllowSynchronousIO to true instead. Synchronous operations are disallowed. Call WriteAsync or set AllowSynchronousIO to true instead. Cannot write to the response body, the response has completed. The connection was aborted by the application. The connection or stream was aborted because a write operation was aborted with a CancellationToken. {name} cannot be set because the response has already started. {name} cannot be set because the response has already started. Request body too large. The maximum request body size cannot be modified after the app has already started reading from the request body. The maximum request body size cannot be modified after the request has been upgraded. Value must be null or a non-negative number. Bad request. Increasing the MaxRequestBodySize conflicts with the max value for IIS limit maxAllowedContentLength. HTTP requests that have a content length greater than maxAllowedContentLength will still be rejected by IIS. You can disable the limit by either removing ... Upgrade requires HTTP/1.1. A helper for wrapping a Stream decorator from an . Computes a minimum segment size A faster version of String.Concat(, , .ToString("X8")) Provides configuration for IIS In-Process. Gets or sets a value that controls whether synchronous IO is allowed for the and Defaults to false. If true the server should set HttpContext.User. If false the server will only provide an identity when explicitly requested by the AuthenticationScheme. Note Windows Authentication must also be enabled in IIS for this to work. Sets the display name shown to users on login pages. The default is null. Gets or sets the maximum unconsumed incoming bytes the server will buffer for incoming request body. Defaults to 1 MB. Used to indicate if the authentication handler should be registered. This is only done if ANCM indicates IIS has a non-anonymous authentication enabled, or for back compat with ANCMs that did not provide this information. Gets or sets the maximum allowed size of any request body in bytes. When set to null, the maximum request length will not be restricted in ASP.NET Core. However, the IIS maxAllowedContentLength will still restrict content length requests (30,000,000 by default). This limit has no effect on upgraded connections which are always unlimited. This can be overridden per-request via . Defaults to 30,000,000 bytes (~28.6 MB). Extension methods for the IIS In-Process. Configures the port and base path the server should listen on when running behind AspNetCoreModule. The app will also be configured to capture startup errors. The to configure. The . Holds data to be displayed on the error page. Detailed information about each exception in the stack. Used to allocate and distribute re-usable blocks of memory. This default value passed in to Rent to use the default value for the pool. Block tracking object used by the byte buffer memory pool. A slab is a large allocation which is divided into smaller blocks. The individual blocks are then treated as independent array segments. Back-reference to the memory pool which this block was allocated from. It may only be returned to this pool. This object cannot be instantiated outside of the static Create method Wraps an array allocated in the pinned object heap in a reusable block of managed memory Back-reference to the memory pool which this block was allocated from. It may only be returned to this pool. Used to allocate and distribute re-usable blocks of memory. The size of a block. 4096 is chosen because most operating systems use 4k pages. The size of a block. 4096 is chosen because most operating systems use 4k pages. Max allocation block size for pooled blocks, larger values can be leased but they will be disposed after use rather than returned to the pool. Thread-safe collection of blocks which are currently in the pool. A slab will pre-allocate all of the block tracking objects and add them to this collection. When memory is requested it is taken from here first, and when it is returned it is re-added. This is part of implementing the IDisposable pattern. This default value passed in to Rent to use the default value for the pool. Register a callback to call when the pool is being disposed. Called to return a block to the pool. Once Return has been called the memory no longer belongs to the caller, and Very Bad Things will happen if the memory is read of modified subsequently. If a caller fails to call Return and the block tracking object is garbage collected, the block tracking object's finalizer will automatically re-create and return a new tracking object into the pool. This will only happen if there is a bug in the server, however it is necessary to avoid leaving "dead zones" in the slab due to lost block tracking objects. The block to return. It must have been acquired by calling Lease on the same memory pool instance. Examines the current usage and activity of the memory pool and evicts a calculated number of unused memory blocks. The eviction policy is adaptive: if the pool is underutilized or idle, more blocks are evicted; if activity is high, fewer or no blocks are evicted. Evicted blocks are removed from the pool and their memory is unrooted for garbage collection. Shows whether was already invoked on this native request context Find the segment of the URI byte array which represents the path. Compare the beginning portion of the raw URL byte array to https:// and http:// The byte array represents the raw URI Length of the matched bytes, 0 if it is not matched. Unescape a given path string in place. The given path string may contain escaped char. The raw path string to be unescaped The unescaped path string Unescape the percent-encodings The iterator point to the first % char The place to write to The end of the buffer The byte array Read the percent-encoding and try unescape it. The operation first peek at the character the iterator points at. If it is % the is then moved on to scan the following to characters. If the two following characters are hexadecimal literals they will be unescaped and the value will be returned. If the first character is not % the iterator will be removed beyond the location of % and -1 will be returned. If the following two characters can't be successfully unescaped the iterator will be move behind the % and -1 will be returned. The value to read The end of the buffer The byte array The unescaped byte if success. Otherwise return -1. Read the next char and convert it into hexadecimal value. The iterator will be moved to the next byte no matter no matter whether the operation successes. The value to read The end of the buffer The byte array The hexadecimal value if successes, otherwise -1. Defines a key/value pair for displaying an item of a dictionary by a debugger. Pretty print a type name. The . true to print a fully qualified name. true to include generic parameter names. true to include generic parameters. Character to use as a delimiter in nested type names The pretty printed type name. Contains details for individual exception messages. An individual exception The generated stack frames Gets or sets the summary message. Contains the source code where the exception occurred. Function containing instruction File containing the instruction The line number of the instruction The line preceding the frame line Lines of code before the actual error line(s). Line(s) of code responsible for the error. Lines of code after the actual error line(s). Specific error details for this stack frame. Infrastructure The request context The request The response The output stream Html encoder used to encode content. Url encoder used to encode content. JavaScript encoder used to encode content. Execute an individual request The stream to write to Execute an individual request Execute an individual request Write the given value without HTML encoding directly to . The to write. Write the given value without HTML encoding directly to . The to write. Writes the given attribute to the given writer The name of the attribute to write The value of the prefix The value of the suffix The s to write. is invoked The to invoke Writes the specified to . The to write. is invoked for types. For all other types, the encoded result of is written to . Writes the specified with HTML encoding to . The to write. Represents a deferred write operation in a . Creates a new instance of . The delegate to invoke when is called. Method invoked to produce content from the . The instance to write to. Startup hooks are pieces of code that will run before a users program main executes See: The type must be named StartupHook without any namespace, and should be internal. Startup hooks are pieces of code that will run before a users program main executes See: Allocator that manages blocks of unmanaged memory. The default block size for the allocator. This size assumes a common page size and provides an accommodation for the pointer chain used to track allocated blocks. Instantiate an instance. The unmanaged memory block size in bytes. Allocate the requested amount of space from the allocator. The type requested The count in units A pointer to the reserved memory. The allocated memory is uninitialized. Allocate the requested amount of space from the allocator. The type requested The count in units A Span to the reserved memory. The allocated memory is uninitialized. Get pointer to bytes for the supplied string in UTF-8. The string The length of the returned byte buffer. A pointer to the buffer of bytes Provides support for efficiently using Tasks to implement the APM (Begin/End) pattern. Marshals the Task as an IAsyncResult, using the supplied callback and state to implement the APM pattern. The Task to be marshaled. The callback to be invoked upon completion. The state to be stored in the IAsyncResult. An IAsyncResult to represent the task's asynchronous operation. Processes an IAsyncResult returned by Begin. The IAsyncResult to unwrap. Processes an IAsyncResult returned by Begin. The IAsyncResult to unwrap. Provides a simple IAsyncResult that wraps a Task. We could use the Task as the IAsyncResult if the Task's AsyncState is the same as the object state, but that's very rare, in particular in a situation where someone cares about allocation, and always using TaskAsyncResult simplifies things and enables additional optimizations. The wrapped Task. Callback to invoke when the wrapped task completes. Initializes the IAsyncResult with the Task to wrap and the associated object state. The Task to wrap. The new AsyncState value. Callback to invoke when the wrapped task completes. Invokes the callback. Gets a user-defined object that qualifies or contains information about an asynchronous operation. Gets a value that indicates whether the asynchronous operation completed synchronously. This is set lazily based on whether the has completed by the time this object is created. Gets a value that indicates whether the asynchronous operation has completed. Gets a that is used to wait for an asynchronous operation to complete. Returns position of first occurrence of item in the A fast access struct that wraps . The type of element to be written. The underlying . The result of the last call to , less any bytes already "consumed" with . Backing field for the property. The number of uncommitted bytes (all the calls to since the last call to ). The total number of bytes written with this writer. Backing field for the property. Initializes a new instance of the struct. The to be wrapped. Gets the result of the last call to . Gets the total number of bytes written with this writer. Calls on the underlying writer with the number of uncommitted bytes. Used to indicate that part of the buffer has been written to. The number of bytes written to. Copies the caller's buffer into this writer and calls with the length of the source buffer. The buffer to copy in. Acquires a new buffer if necessary to ensure that some given number of bytes can be written to a single buffer. The number of bytes that must be allocated in a single buffer. Gets a fresh span to write to, with an optional minimum size. The minimum size for the next requested buffer. Copies the caller's buffer into this writer, potentially across multiple buffers from the underlying writer. The buffer to copy into this writer. A is a reader-writer pair, where content written to the writer can be read from the reader. An is *not* a pipe. It is also a reader-writer pair, but the reader and writer are not connected. Rather, it can be regarded as *one end* of a two-way (i.e. duplex) communication channel, where content written to the writer is sent to the counterparty and content received from the counterparty is readable from the reader. A is a pair of instances, each of which represents one end of a two-way communication channel. (In a sense, this makes it a "duplex pipe".) It can also be viewed as a pair of s, as these underlie the instances. In either view, it is composed of two s and two s - it is only how they are grouped that differs. The IN6_ADDR structure specifies an IPv6 transport address. All members of the IN6_ADDR structure must be specified in network-byte-order (big-endian). A union that contains the following different representations of the IPv6 transport address: Read more on docs.microsoft.com. The in_addr structure represents an IPv4 address. The IPaddr type definition also represents an IPv4 address and can be cast to an in_addr structure when needed. On the Microsoft Windows Software Development Kit (SDK) released for Windows Vista and later, the organization of header files has changed and the in_addr structure is defined in the Inaddr.h header file which is automatically included by the Ipexport.h header file. On the Platform Software Development Kit (SDK) released for Windows Server 2003 and Windows XP, the in_addr structure is declared in the Ipexport.h header file. Read more on docs.microsoft.com. The sockaddr structure varies depending on the protocol selected. (sockaddr) Learn more about this API from docs.microsoft.com. The SOCKADDR_IN (winsock.h) structure varies depending on the protocol selected. Learn more about this API from docs.microsoft.com. Defines the authentication state of a request. Learn more about this API from docs.microsoft.com. The request was successfully authenticated for the authentication type indicated in the HTTP_REQUEST_AUTH_INFO structure. Authentication was configured on the URL group for this request, however, the HTTP Server API did not handle the authentication. This could be because of one of the following reasons: This doc was truncated. Read more on docs.microsoft.com. This doc was truncated. Read more on docs.microsoft.com. The HTTP_BYTE_RANGE structure is used to specify a byte range within a cached response fragment, file, or other data block. Learn more about this API from docs.microsoft.com. Starting offset of the byte range. Size, in bytes, of the range. If this member is HTTP_BYTE_RANGE_TO_EOF, the range extends from the starting offset to the end of the file or data block. Contains a validated, canonical, UTF-16 Unicode-encoded URL request string together with pointers into it and element lengths. For example, if pFullUrl is "http://www.fabrikam.com/path1/path2/file.ext?n1=v1&n2=v2", then pHost points to "www.fabrikam", pAbsPath points to "/path1/…" and pQueryString points to "?n1=v1…". Size, in bytes, of the data pointed to by the pFullUrl member, not including a terminating null character. Size, in bytes, of the data pointed to by the pHost member. Size, in bytes, of the data pointed to by the pAbsPath member. Size, in bytes, of the data pointed to by the pQueryString member. Pointer to the scheme element at the beginning of the URL (must be either "http://..." or "https://..."). Pointer to the first character in the host element, immediately following the double slashes at the end of the scheme element. Pointer to the third forward slash ("/") in the string. In a UrlPrefix string, this is the slash immediately preceding the relativeUri element. Pointer to the first question mark (?) in the string, or NULL if there is none. Represents an individual block of data either in memory, in a file, or in the HTTP Server API response-fragment cache. Learn more about this API from docs.microsoft.com. Type of data store. This member can be one of the values from the HTTP_DATA_CHUNK_TYPE enumeration. Defines the data source for a data chunk. Learn more about this API from docs.microsoft.com. The data source is a memory data block. The union should be interpreted as a FromMemory structure. The data source is a file handle data block. The union should be interpreted as a FromFileHandle structure. The data source is a fragment cache data block. The union should be interpreted as a FromFragmentCache structure. The data source is a fragment cache data block. The union should be interpreted as a FromFragmentCacheEx structure. Windows Server 2003 with SP1 and Windows XP with SP2:  This flag is not supported. Read more on docs.microsoft.com. The data source is a trailers data block. The union should be interpreted as a Trailers structure. Windows 10, version 2004 and prior:  This flag is not supported. Read more on docs.microsoft.com. Contains the header values for a known header from an HTTP request or HTTP response. In the HTTP Server API, known headers are defined as those that are enumerated in the HTTP_HEADER_ID enumeration type. Be aware that there are different lists of different sizes for request and response headers. For more information about the structure and usage of HTTP headers, see the RFC 2616. Read more on docs.microsoft.com. Size, in bytes, of the 8-bit string pointed to by the pRawValue member, not counting a terminating null character, if present. If RawValueLength is zero, then the value of the pRawValue element is meaningless. Pointer to the text of this HTTP header. Use RawValueLength to determine where this text ends rather than relying on the string to have a terminating null. The format of the header text is specified in RFC 2616. Read more on docs.microsoft.com. The length of the inline array. Gets this inline array as a span. ⚠ Important ⚠: When this struct is on the stack, do not let the returned span outlive the stack frame that defines it. Gets this inline array as a span. ⚠ Important ⚠: When this struct is on the stack, do not let the returned span outlive the stack frame that defines it. Contains the authentication status of the request with a handle to the client token that the receiving process can use to impersonate the authenticated client. Starting with HTTP version 2.0, the HTTP_REQUEST structure contains an HTTP_REQUEST_INFO structure. The pVoid member of the HTTP_REQUEST_INFO structure points to the HTTP_REQUEST_AUTH_INFO when the request information type is HttpRequestInfoTypeAuth. When the application receives a request with this structure and the request has not been authenticated, it can send the initial 401 challenge with the desired set of WWW-Authenticate headers in the HTTP_MULTIPLE_KNOWN_HEADERS structure. When the HTTP Server API completes the authentication handshake, it fills the HTTP_REQUEST_AUTH_INFO structure and passes it to the application with the request again. The handle to the access token that represents the client identity is provided in this structure by the HTTP Server API. Context Attributes The ContextAttributes member is provided for SSPI based schemes. For example, SSPI applications can determine whether ASC_RET_MUTUAL_AUTH is set for a mutually authenticated session. The HTTP Server API does not provide the expiration time for the context in the PackedContext member. Applications may require the expiration time in specific circumstances, for example, when NTLM credential caching is enabled and the application queries for the expiration time for a cached context. If the server application requires the expiration time for the underlying client context associated with the access token, it can receive the packed context and call QueryContextAttributes with the SECPKG_ATTR_LIFESPAN. Mutual Authentication Data By default, the HTTP Server API ensures that the mutual authentication data is added to the final 200 response; in general, server applications are not responsible for sending the mutual authentication data. However, applications can receive the mutual authentication data and send it with the final response. When the ReceiveMutualAuth member of the HTTP_SERVER_AUTHENTICATION_INFO structure is set to true, applications receive the server credentials for mutual authentication along with the authenticated request. The mutual authentication data provided in the pMutualAuthData member contains the exact value of WWW-Authenticate header without the header name. For example, pMutualAuthData points to "Negotiate ade02938481eca". The application builds the WWW-Authenticate header by appending the provided pMutualAuthData as a response header value. Read more on docs.microsoft.com. A member of the HTTP_AUTH_STATUS enumeration that indicates the final authentication status of the request. If the authentication status is not HttpAuthStatusSuccess, applications should disregard members of this structure except AuthStatus, SecStatus, and AuthType. Read more on docs.microsoft.com. A SECURITY_STATUS value that indicates the security failure status when the AuthStatus member is HttpAuthStatusFailure. The authentication flags that indicate the following authentication attributes: This doc was truncated. Read more on docs.microsoft.com. A member of the HTTP_REQUEST_AUTH_TYPE enumeration that indicates the authentication scheme attempted or established for the request. A handle to the client token that the receiving process can use to impersonate the authenticated client. The handle to the token should be closed by calling CloseHandle when it is no longer required. This token is valid only for the lifetime of the request. Applications can regenerate the initial 401 challenge to reauthenticate when the token expires. Read more on docs.microsoft.com. The client context attributes for the access token. The length, in bytes, of the PackedContext. The type of context in the PackedContext member. The security context for the authentication type. Applications can query the attributes of the packed context by calling the SSPI QueryContextAttributes API. However, applications must acquire a credential handle for the security package for the indicated AuthType. Application should call the SSPI FreeContextBuffer API to free the serialized context when it is no longer required. Read more on docs.microsoft.com. The length, in bytes, of the pMutualAuthData member. The Base64 encoded mutual authentication data used in the WWW-Authenticate header. The HTTP_REQUEST_AUTH_TYPE enumeration defines the authentication types supported by the HTTP Server API.This enumeration is used in the HTTP_REQUEST_AUTH_INFO structure. Learn more about this API from docs.microsoft.com. No authentication is attempted for the request. Basic authentication is attempted for the request. Digest authentication is attempted for the request. NTLM authentication is attempted for the request. Negotiate authentication is attempted for the request. Kerberos authentication is attempted for the request. Contains headers sent with an HTTP request. Learn more about this API from docs.microsoft.com. A number of unknown headers sent with the HTTP request. This number is the size of the array pointed to by the pUnknownHeaders member. A pointer to an array of HTTP_UNKNOWN_HEADER structures. This array contains one structure for each of the unknown headers sent in the HTTP request. Read more on docs.microsoft.com. This member is reserved and must be zero. This member is reserved and must be NULL. Fixed-size array of HTTP_KNOWN_HEADER structures. The HTTP_HEADER_ID enumeration provides a mapping from header types to array indexes. If a known header of a given type is included in the HTTP request, the array element at the index that corresponds to that type specifies the header value. Those elements of the array for which no corresponding headers are present contain a zero-valued RawValueLength member. Use RawValueLength to determine the end of the header string pointed to by pRawValue, rather than relying on the string to have a terminating null. Read more on docs.microsoft.com. Extends the HTTP_REQUEST structure with additional information about the request. Starting with the HTTP Server API version 2.0, the HTTP_REQUEST structure is extended to include an array of HTTP_REQUEST_INFO structures in the pRequestInfo member. These structures contain additional information for the request. A member of the HTTP_REQUEST_INFO_TYPE enumeration specifying the type of information contained in this structure. The length, in bytes, of the pInfo member. A pointer to the HTTP_REQUEST_AUTH_INFO structure when the InfoType member is HttpRequestInfoTypeAuth; otherwise NULL. The HTTP_REQUEST_INFO_TYPE enumeration defines the type of information contained in the HTTP_REQUEST_INFO structure. This enumeration is used in the HTTP_REQUEST_INFO structure. Learn more about this API from docs.microsoft.com. The request information type is authentication. The pInfo member of the HTTP_REQUEST_INFO structure points to a HTTP_REQUEST_AUTH_INFO structure. Read more on docs.microsoft.com. Defines the properties that are configured by the HTTP Server API on a request. The **HTTP\_REQUEST\_PROPERTY** enumeration types are used to set or query the configurations on a request. A member of this enumeration together with the associated configuration structure is used by [HttpSetRequestProperty](/windows/desktop/api/http/nf-http-httpsetrequestproperty) to define the configuration parameters. The HTTP/2 or HTTP/3 stream error on the request. The [HTTP\_REQUEST\_PROPERTY\_STREAM\_ERROR](/windows/win32/api/http/ns-http-http_request_property_stream_error) structure contains the configuration data for this property. Read more on docs.microsoft.com. Uses the HTTP_REQUEST structure to return data associated with a specific request. The unprocessed URL contained in the pRawUrl member is for tracking and statistical purposes only. For other purposes, use the processed, canonical URL contained in the CookedUrl member. A combination of zero or more of the following flag values may be combined, with OR, as appropriate. This doc was truncated. Read more on docs.microsoft.com. An identifier for the connection on which the request was received. Use this value when calling HttpWaitForDisconnect or HttpReceiveClientCertificate. Read more on docs.microsoft.com. A value used to identify the request when calling HttpReceiveRequestEntityBody, HttpSendHttpResponse, and/or HttpSendResponseEntityBody. Read more on docs.microsoft.com. The context that is associated with the URL in the pRawUrl parameter. Windows Server 2003 with SP1 and Windows XP with SP2:   Read more on docs.microsoft.com. An HTTP_VERSION structure that contains the version of HTTP specified by this request. Read more on docs.microsoft.com. An HTTP verb associated with this request. This member can be one of the values from the HTTP_VERB enumeration. Read more on docs.microsoft.com. If the Verb member contains a value equal to HttpVerbUnknown, the UnknownVerbLength member contains the size, in bytes, of the string pointed to by the pUnknownVerb member, not including the terminating null character. If Verb is not equal to HttpVerbUnknown, UnknownVerbLength is equal to zero. The size, in bytes, of the unprocessed URL string pointed to by the pRawUrl member, not including the terminating null character. If the Verb member is equal to HttpVerbUnknown, pUnknownVerb, points to a null-terminated string of octets that contains the HTTP verb for this request; otherwise, the application ignores this parameter. A pointer to a string of octets that contains the original, unprocessed URL targeted by this request. Use this unprocessed URL only for tracking or statistical purposes; the CookedUrl member contains the canonical form of the URL for general use. An HTTP_COOKED_URL structure that contains a parsed canonical wide-character version of the URL targeted by this request. This is the version of the URL HTTP Listeners should act upon, rather than the raw URL. Read more on docs.microsoft.com. An HTTP_TRANSPORT_ADDRESS structure that contains the transport addresses for the connection for this request. Read more on docs.microsoft.com. An HTTP_REQUEST_HEADERS structure that contains the headers specified in this request. Read more on docs.microsoft.com. The total number of bytes received from the network comprising this request. The number of elements in the pEntityChunks array. If no entity body was copied, this value is zero. A pointer to an array of HTTP_DATA_CHUNK structures that contains the data blocks making up the entity body. HttpReceiveHttpRequest does not copy the entity body unless called with the HTTP_RECEIVE_REQUEST_FLAG_COPY_BODY flag set. Read more on docs.microsoft.com. Raw connection ID for an Secure Sockets Layer (SSL) request. A pointer to an HTTP_SSL_INFO structure that contains Secure Sockets Layer (SSL) information about the connection on which the request was received. Read more on docs.microsoft.com. Extends the HTTP_REQUEST_V1 request structure with more information about the request. Learn more about this API from docs.microsoft.com. The number of HTTP_REQUEST_INFO structures in the array pointed to by pRequestInfo. A pointer to an array of HTTP_REQUEST_INFO structures that contains additional information about the request. Contains data about a Secure Sockets Layer (SSL) client certificate that can be used to determine whether the certificate is valid. An HTTP_SSL_CLIENT_CERT_INFO structure is pointed to by the pClientCertInfo member of the HTTP_SSL_INFO structure, and is used by the HttpReceiveClientCertificate function to return data about the client certificate through the pSslClientCertInfo parameter. Read more on docs.microsoft.com. Flags that indicate whether the certificate is valid. The possible values for this member are a SSPI Status Code returned from SSPI or one of the following flags from the dwError member of the CERT_CHAIN_POLICY_STATUS structure: Read more on docs.microsoft.com. The size, in bytes, of the certificate. A pointer to the actual certificate. A handle to an access token. If the HTTP_SERVICE_CONFIG_SSL_FLAG_USE_DS_MAPPER flag is set using the HttpSetServiceConfiguration function, and the client certificate was successfully mapped to an operating-system user account, then this member contains the handle to a valid access token. When the HTTP_SSL_CLIENT_CERT_INFO structure is no longer required, release this token explicitly by closing the handle. Read more on docs.microsoft.com. Reserved. Contains data for a connection that uses Secure Sockets Layer (SSL), obtained through the SSL handshake. An HTTP_SSL_INFO structure can be pointed to by the pSslInfo member of an HTTP_REQUEST structure. Read more on docs.microsoft.com. The size, in bytes, of the public key used to sign the server certificate. The size, in bytes, of the cipher key used to encrypt the current session. The size, in bytes, of the string pointed to by the pServerCertIssuer member not including the terminating null character. The size, in bytes, of the string pointed to by the pServerCertSubject member not including the terminating null character. A pointer to a null-terminated string of octets that specifies the name of the entity that issued the certificate. A pointer to a null-terminated string of octets that specifies the name of the entity to which the certificate belongs. A pointer to an HTTP_SSL_CLIENT_CERT_INFO structure that specifies the client certificate. Read more on docs.microsoft.com. If non-zero, indicates that the client certificate is already present locally. Specifies the addresses (local and remote) used for a particular HTTP connection. Although the pRemoteAddress and pLocalAddress members are formally declared as PSOCKADDR, they are in fact PSOCKADDR_IN or PSOCKADDR_IN6 types. Inspect the sa_family member, which is the same in all three structures, to determine how to access the address. If sa_family is equal to AF_INET, then the address is in IPv4 form and can be accessed by casting the members to PSOCKADDR_IN, but if sa_family equals AF_INET6, the address is in IPv6 form and you must cast them to PSOCKADDR_IN6 before accessing the address. Both pLocalAddress and pRemoteAddress are always of the same type; that is they are either both of type PSOCKADDR_IN or both of type PSOCKADDR_IN6. A pointer to the remote IP address associated with this connection. For more information about how to access this address, see the Remarks section. A pointer to the local IP address associated with this connection. For more information about how to access this address, see the Remarks section. Contains the name and value for a header in an HTTP request or response whose name does not appear in the enumeration. Learn more about this API from docs.microsoft.com. The size, in bytes, of the data pointed to by the pName member not counting a terminating null. The size, in bytes, of the data pointed to by the pRawValue member, in bytes. A pointer to a string of octets that specifies the header name. Use NameLength to determine the end of the string, rather than relying on a terminating null. A pointer to a string of octets that specifies the values for this header. Use RawValueLength to determine the end of the string, rather than relying on a terminating null. The HTTP_VERB enumeration type defines values that are used to specify known, standard HTTP verbs in the HTTP_REQUEST structure. The majority of these known verbs are documented in RFC 2616 and RFC 2518, as indicated below. Learn more about this API from docs.microsoft.com. Not relevant for applications; used only in kernel mode. Indicates that the application can examine the UnknownVerbLength and pUnknownVerb members of the HTTP_REQUEST structure to retrieve the HTTP verb for the request. This is the case in an HTTP/1.1 request when a browser client specifies a custom verb. Not relevant for applications; used only in kernel mode. The OPTIONS method requests information about the communication options and requirements associated with a URI. See page 52 of RFC 2616. Read more on docs.microsoft.com. The GET method retrieves the information or entity that is identified by the URI of the Request. If that URI refers to a script or other data-producing process, it is the data produced, not the text of the script, that is returned in the response. A GET method can be made conditional or partial by including a conditional or Range header field in the request. A conditional GET requests that the entity be sent only if all conditions specified in the header are met, and a partial GET requests only part of the entity, as specified in the Range header. Both of these forms of GET can help avoid unnecessary network traffic. See page 53 of RFC 2616. Read more on docs.microsoft.com. The HEAD method is identical to GET except that the server only returns message-headers in the response, without a message-body. The headers are the same as would be returned in response to a GET. See page 54 of RFC 2616. Read more on docs.microsoft.com. The POST method is used to post a new entity as an addition to a URI. The URI identifies an entity that consumes the posted data in some fashion. See page 54 of RFC 2616. Read more on docs.microsoft.com. The PUT method is used to replace an entity identified by a URI. See page 55 of RFC 2616. Read more on docs.microsoft.com. The DELETE method requests that a specified URI be deleted. See page 56 of RFC 2616. Read more on docs.microsoft.com. The TRACE method invokes a remote, application-layer loop-back of the request message. It allows the client to see what is being received at the other end of the request chain for diagnostic purposes. See page 56 of RFC 2616. Read more on docs.microsoft.com. The CONNECT method can be used with a proxy that can dynamically switch to tunneling, as in the case of SSL tunneling. See page 57 of RFC 2616. Read more on docs.microsoft.com. The TRACK method is used by Microsoft Cluster Server to implement a non-logged trace. The MOVE method requests a WebDAV operation equivalent to a copy (COPY), followed by consistency maintenance processing, followed by a delete of the source, where all three actions are performed atomically. When applied to a collection, "Depth" is assumed to be or must be specified as "infinity". See page 42 of RFC 2518. Read more on docs.microsoft.com. The COPY method requests a WebDAV operation that creates a duplicate of the source resource, identified by the Request URI, in the destination resource, identified by a URI specified in the Destination header. See page 37 of RFC 2518. Read more on docs.microsoft.com. The PROPFIND method requests a WebDAV operation that retrieves properties defined on the resource identified by the Request-URI. See page 24 of RFC 2518. Read more on docs.microsoft.com. The PROPPATCH method requests a WebDAV operation that sets and/or removes properties defined on the resource identified by the Request-URI. See page 31 of RFC 2518. Read more on docs.microsoft.com. The MKCOL method requests a WebDAV operation that creates a new collection resource at the location specified by the Request-URI. See page 33 of RFC 2518. Read more on docs.microsoft.com. The LOCK method requests a WebDAV operation that creates a lock as specified by the lockinfo XML element on the Request-URI. See page 45 of RFC 2518. Read more on docs.microsoft.com. The UNLOCK method requests a WebDAV operation that removes a lock, identified by a lock token in the Lock-Token request header, from the resource identified by the Request-URI, and from all other resources included in the lock. See page 51 of RFC 2518. Read more on docs.microsoft.com. The SEARCH method requests a WebDAV operation used by Microsoft Exchange to search folders. See the Internet Engineering Task Force (IETF) Internet Draft WebDAV SEARCH for more information, and the WebDAV Web site for possible updates. Read more on docs.microsoft.com. Terminates the enumeration; is not used to define a verb. Defines a version of the HTTP protocol that a request requires or a response provides. For more information about the HTTP protocol, see RFC 2616. The following macros define various versions of the HTTP protocol:"#define HTTP_VERSION_UNKNOWN { 0, 0 }""#define HTTP_VERSION_0_9 { 0, 9 }""#define HTTP_VERSION_1_0 { 1, 0 }""#define HTTP_VERSION_1_1 { 1, 1 }" The HTTP Server API provides a number of macros that can be used to evaluate the value of an HTTP_VERSION structure; For more information, see HTTP Server API Version 1.0 Macros.
Note  The HTTP Server API rejects a version of HTTP larger than 65,535 in either the major or minor portion. If a request includes such a version number, the HTTP Server API discards it and returns a response with status 400 ("Bad Request").
 
 Read more on docs.microsoft.com. Major version of the HTTP protocol. Minor version of the HTTP protocol. The length of the inline array. Gets this inline array as a span. ⚠ Important ⚠: When this struct is on the stack, do not let the returned span outlive the stack frame that defines it. Gets this inline array as a span. ⚠ Important ⚠: When this struct is on the stack, do not let the returned span outlive the stack frame that defines it. The length of the inline array. Gets this inline array as a span. ⚠ Important ⚠: When this struct is on the stack, do not let the returned span outlive the stack frame that defines it. Gets this inline array as a span. ⚠ Important ⚠: When this struct is on the stack, do not let the returned span outlive the stack frame that defines it. The **HRESULT** data type is the same as the [SCODE](scode.md) data type. An **HRESULT** value consists of the following fields: - A 1-bit code indicating severity, where zero represents success and 1 represents failure. - A 4-bit reserved value. - An 11-bit code indicating responsibility for the error or warning, also known as a facility code. - A 16-bit code describing the error or warning. Most MAPI interface methods and functions return **HRESULT** values to provide detailed cause formation. **HRESULT** values are also used widely in OLE interface methods. OLE provides several macros for converting between **HRESULT** values and **SCODE** values, another common data type for error handling. > [!NOTE] > In 64-bit MAPI, **HRESULT** is still a 32-bit value. For information about the OLE use of **HRESULT** values, see the *OLE Programmer's Reference*. For more information about the use of these values in MAPI, see [Error Handling](error-handling-in-mapi.md) and any of the following interface methods: [IABLogon::GetLastError](iablogon-getlasterror.md) [IMAPISupport::GetLastError](imapisupport-getlasterror.md) [IMAPIControl::GetLastError](imapicontrol-getlasterror.md) [IMAPITable::GetLastError](imapitable-getlasterror.md) [IMAPIProp::GetLastError](imapiprop-getlasterror.md) [IMAPIViewAdviseSink::OnPrint](imapiviewadvisesink-onprint.md) Read more on docs.microsoft.com. A pointer to the IErrorInfo interface that provides more information about the error. You can specify to use the current IErrorInfo interface, or new IntPtr(-1) to ignore the current IErrorInfo interface and construct the exception just from the error code. , if it does not reflect an error. A pointer to a null-terminated, constant, ANSI character string. A pointer to the first character in the string. The content should be considered readonly, as it was typed as constant in the SDK. Gets the number of characters up to the first null character (exclusive). Returns a with a copy of this character array, decoding as UTF-8. A , or if is . Returns a span of the characters in this string, up to the first null character (exclusive). A pointer to a null-terminated, constant character string. A pointer to the first character in the string. The content should be considered readonly, as it was typed as constant in the SDK. Gets the number of characters up to the first null character (exclusive). Returns a with a copy of this character array, up to the first null character (exclusive). A , or if is . Returns a span of the characters in this string, up to the first null character (exclusive). Returns a span of the characters in this string, up to the first null character (exclusive). Returns a span of the characters in this string, up to the first null character (exclusive). The length of the inline array. Gets a ref to an individual element of the inline array. ⚠ Important ⚠: When this struct is on the stack, do not let the returned reference outlive the stack frame that defines it. Gets this inline array as a span. ⚠ Important ⚠: When this struct is on the stack, do not let the returned span outlive the stack frame that defines it. Gets this inline array as a span. ⚠ Important ⚠: When this struct is on the stack, do not let the returned span outlive the stack frame that defines it. The length of the inline array. Gets a ref to an individual element of the inline array. ⚠ Important ⚠: When this struct is on the stack, do not let the returned reference outlive the stack frame that defines it. Gets this inline array as a span. ⚠ Important ⚠: When this struct is on the stack, do not let the returned span outlive the stack frame that defines it. Gets this inline array as a span. ⚠ Important ⚠: When this struct is on the stack, do not let the returned span outlive the stack frame that defines it. Copies the fixed array to a new string up to the specified length regardless of whether there are null terminating characters. Thrown when is less than 0 or greater than . Copies the fixed array to a new string, stopping before the first null terminator character or at the end of the fixed array (whichever is shorter). Contains extern methods from "KERNEL32.dll". Closes an open object handle. A valid handle to an open object. If the function succeeds, the return value is nonzero. If the function fails, the return value is zero. To get extended error information, call GetLastError. If the application is running under a debugger, the function will throw an exception if it receives either a handle value that is not valid or a pseudo-handle value. This can happen if you close a handle twice, or if you call CloseHandle on a handle returned by the FindFirstFile function instead of calling the FindClose function. The CloseHandle function closes handles to the following objects: This doc was truncated. Read more on docs.microsoft.com. The length of the inline array. Gets a ref to an individual element of the inline array. ⚠ Important ⚠: When this struct is on the stack, do not let the returned reference outlive the stack frame that defines it. Gets this inline array as a span. ⚠ Important ⚠: When this struct is on the stack, do not let the returned span outlive the stack frame that defines it. Gets this inline array as a span. ⚠ Important ⚠: When this struct is on the stack, do not let the returned span outlive the stack frame that defines it.