Contains process status information for a service. The ControlServiceEx, EnumServicesStatusEx, NotifyServiceStatusChange, and QueryServiceStatusEx functions use this structure.
Syntax
Members
The type of service. This member can be one of the following values.
Value
Meaning
SERVICE_FILE_SYSTEM_DRIVER 0x00000002
The service is a file system driver.
SERVICE_KERNEL_DRIVER 0x00000001
The service is a device driver.
SERVICE_WIN32_OWN_PROCESS 0x00000010
The service runs in its own process.
SERVICE_WIN32_SHARE_PROCESS 0x00000020
The service shares a process with other services.
В
If the service type is either SERVICE_WIN32_OWN_PROCESS or SERVICE_WIN32_SHARE_PROCESS, and the service is running in the context of the LocalSystem account, the following type may also be specified.
Value
Meaning
SERVICE_INTERACTIVE_PROCESS
The service can interact with the desktop.
The current state of the service. This member can be one of the following values.
Value
Meaning
SERVICE_CONTINUE_PENDING 0x00000005
The service is about to continue.
SERVICE_PAUSE_PENDING 0x00000006
The service is pausing.
SERVICE_PAUSED 0x00000007
The service is paused.
SERVICE_RUNNING 0x00000004
The service is running.
SERVICE_START_PENDING 0x00000002
The service is starting.
SERVICE_STOP_PENDING 0x00000003
The service is stopping.
SERVICE_STOPPED 0x00000001
The service has stopped.
The control codes the service accepts and processes in its handler function (see Handler and HandlerEx). A user interface process can control a service by specifying a control command in the ControlService or ControlServiceEx function. By default, all services accept the SERVICE_CONTROL_INTERROGATE value.
The following are the control codes.
Control code
Meaning
SERVICE_ACCEPT_NETBINDCHANGE 0x00000010
The service is a network component that can accept changes in its binding without being stopped and restarted.
This control code allows the service to receive SERVICE_CONTROL_NETBINDADD, SERVICE_CONTROL_NETBINDREMOVE, SERVICE_CONTROL_NETBINDENABLE, and SERVICE_CONTROL_NETBINDDISABLE notifications.
SERVICE_ACCEPT_PARAMCHANGE 0x00000008
The service can reread its startup parameters without being stopped and restarted.
This control code allows the service to receive SERVICE_CONTROL_PARAMCHANGE notifications.
SERVICE_ACCEPT_PAUSE_CONTINUE 0x00000002
The service can be paused and continued.
This control code allows the service to receive SERVICE_CONTROL_PAUSE and SERVICE_CONTROL_CONTINUE notifications.
SERVICE_ACCEPT_PRESHUTDOWN 0x00000100
The service can perform preshutdown tasks.
This control code enables the service to receive SERVICE_CONTROL_PRESHUTDOWN notifications. Note that ControlService and ControlServiceEx cannot send this notification; only the system can send it.
Windows ServerВ 2003 and WindowsВ XP:В В This value is not supported.
SERVICE_ACCEPT_SHUTDOWN 0x00000004
The service is notified when system shutdown occurs.
This control code allows the service to receive SERVICE_CONTROL_SHUTDOWN notifications. Note that ControlService and ControlServiceEx cannot send this notification; only the system can send it.
SERVICE_ACCEPT_STOP 0x00000001
The service can be stopped.
This control code allows the service to receive SERVICE_CONTROL_STOP notifications.
This member can also contain the following extended control codes, which are supported only by HandlerEx. (Note that these control codes cannot be sent by ControlService or ControlServiceEx.)
Control code
Meaning
SERVICE_ACCEPT_HARDWAREPROFILECHANGE 0x00000020
The service is notified when the computer’s hardware profile has changed. This enables the system to send SERVICE_CONTROL_HARDWAREPROFILECHANGE notifications to the service.
SERVICE_ACCEPT_POWEREVENT 0x00000040
The service is notified when the computer’s power status has changed. This enables the system to send SERVICE_CONTROL_POWEREVENT notifications to the service.
SERVICE_ACCEPT_SESSIONCHANGE 0x00000080
The service is notified when the computer’s session status has changed. This enables the system to send SERVICE_CONTROL_SESSIONCHANGE notifications to the service.
The error code that the service uses to report an error that occurs when it is starting or stopping. To return an error code specific to the service, the service must set this value to ERROR_SERVICE_SPECIFIC_ERROR to indicate that the dwServiceSpecificExitCode member contains the error code. The service should set this value to NO_ERROR when it is running and when it terminates normally.
The service-specific error code that the service returns when an error occurs while the service is starting or stopping. This value is ignored unless the dwWin32ExitCode member is set to ERROR_SERVICE_SPECIFIC_ERROR.
The check-point value that the service increments periodically to report its progress during a lengthy start, stop, pause, or continue operation. For example, the service should increment this value as it completes each step of its initialization when it is starting up. The user interface program that invoked the operation on the service uses this value to track the progress of the service during a lengthy operation. This value is not valid and should be zero when the service does not have a start, stop, pause, or continue operation pending.
The estimated time required for a pending start, stop, pause, or continue operation, in milliseconds. Before the specified amount of time has elapsed, the service should make its next call to the SetServiceStatus function with either an incremented dwCheckPoint value or a change in dwCurrentState. If the amount of time specified by dwWaitHint passes, and dwCheckPoint has not been incremented or dwCurrentState has not changed, the service control manager or service control program can assume that an error has occurred and the service should be stopped. However, if the service shares a process with other services, the service control manager cannot terminate the service application because it would have to terminate the other services sharing the process as well.
The process identifier of the service.
This member can be one of the following values.
Value
Meaning
0
The service is running in a process that is not a system process, or it is not running.
If the service is running in a process that is not a system process, dwProcessId is nonzero. If the service is not running, dwProcessId is zero.
Http Status Code Перечисление
Определение
Содержит значения кодов состояний, определенных для протокола HTTP. Contains the values of status codes defined for HTTP.
Эквивалент HTTP-состояния 202. Equivalent to HTTP status 202. Значение Accepted указывает, что запрос принят для дальнейшей обработки. Accepted indicates that the request has been accepted for further processing.
Эквивалент HTTP-состояния 208. Equivalent to HTTP status 208. AlreadyReported указывает, что элементы привязки WebDAV уже перечислены в предыдущей части ответа с несколькими состояниями и не включаются снова. AlreadyReported indicates that the members of a WebDAV binding have already been enumerated in a preceding part of the multistatus response, and are not being included again.
Эквивалент HTTP-состояния 300. Equivalent to HTTP status 300. Ambiguous указывает, что запрашиваемые данные имеют несколько представлений. Ambiguous indicates that the requested information has multiple representations. Действие, выполняемое по умолчанию, состоит в перенаправлении и отслеживании данных заголовка Location, связанного с этим ответом. The default action is to treat this status as a redirect and follow the contents of the Location header associated with this response. Ambiguous — синоним MultipleChoices . Ambiguous is a synonym for MultipleChoices .
Эквивалент HTTP-состояния 502. Equivalent to HTTP status 502. Значение BadGateway указывает, что промежуточный прокси-сервер получил неправильный ответ от другого прокси или исходного сервера. BadGateway indicates that an intermediate proxy server received a bad response from another proxy or the origin server.
Эквивалент HTTP-состояния 400. Equivalent to HTTP status 400. BadRequest указывает, что запрос не может быть воспринят сервером. BadRequest indicates that the request could not be understood by the server. BadRequest посылается, когда не применима любая другая ошибка или ошибка является неизвестной либо не имеет собственного кода ошибки. BadRequest is sent when no other error is applicable, or if the exact error is unknown or does not have its own error code.
Эквивалент HTTP-состояния 409. Equivalent to HTTP status 409. Conflict указывает, что запрос не может быть выполнен из-за конфликта на сервере. Conflict indicates that the request could not be carried out because of a conflict on the server.
Эквивалент HTTP-состояния 100. Equivalent to HTTP status 100. Continue указывает, что клиент может продолжать выполнять свой запрос. Continue indicates that the client can continue with its request.
Эквивалент HTTP-состояния 201. Equivalent to HTTP status 201. Created указывает, что запрос привел к созданию нового ресурса до того, как был послан ответ. Created indicates that the request resulted in a new resource created before the response was sent.
Эквивалент HTTP-состояния 103. Equivalent to HTTP status 103. EarlyHints указывает клиенту, что сервер, скорее всего, отправляет окончательный ответ с полями заголовка, включенными в информационный ответ. EarlyHints indicates to the client that the server is likely to send a final response with the header fields included in the informational response.
Эквивалент HTTP-состояния 417. Equivalent to HTTP status 417. ExpectationFailed указывает, что ожидание, заданное в заголовке Expect, не может быть выполнено сервером. ExpectationFailed indicates that an expectation given in an Expect header could not be met by the server.
Эквивалент HTTP-состояния 424. Equivalent to HTTP status 424. FailedDependency указывает, что метод не может быть выполнен для ресурса, так как запрошенное действие зависит от другого действия, и это действие не выполнено. FailedDependency indicates that the method couldn’t be performed on the resource because the requested action depended on another action and that action failed.
Эквивалент HTTP-состояния 403. Equivalent to HTTP status 403. Forbidden указывает, что сервер отказывается выполнять запрос. Forbidden indicates that the server refuses to fulfill the request.
Эквивалент HTTP-состояния 302. Equivalent to HTTP status 302. Found указывает, что запрашиваемые данные расположены по универсальному коду ресурса (URI), заданному в заголовке Location. Found indicates that the requested information is located at the URI specified in the Location header. Действие, выполняемое по умолчанию при получении этого состояния, состоит в отслеживании заголовка Location, связанного с ответом. The default action when this status is received is to follow the Location header associated with the response. Если для исходного запроса использовался метод POST, перенаправляемый запрос будет использовать метод GET. When the original request method was POST, the redirected request will use the GET method. Found — синоним Redirect . Found is a synonym for Redirect .
Эквивалент HTTP-состояния 504. Equivalent to HTTP status 504. Значение GatewayTimeout указывает, что промежуточный прокси-сервер простаивает, ожидая ответа от другого прокси или исходного сервера. GatewayTimeout indicates that an intermediate proxy server timed out while waiting for a response from another proxy or the origin server.
Эквивалент HTTP-состояния 410. Equivalent to HTTP status 410. Gone указывает, что запрашиваемый ресурс больше недоступен. Gone indicates that the requested resource is no longer available.
Эквивалент HTTP-состояния 505. Equivalent to HTTP status 505. HttpVersionNotSupported указывает, что запрашиваемая версия HTTP не поддерживается сервером. HttpVersionNotSupported indicates that the requested HTTP version is not supported by the server.
Эквивалент HTTP-состояния 226. Equivalent to HTTP status 226. IMUsed указывает, что сервер выполнил запрос к ресурсу, а ответ является представлением результата одной или нескольких манипуляций с экземплярами, примененным к текущему экземпляру. IMUsed indicates that the server has fulfilled a request for the resource, and the response is a representation of the result of one or more instance-manipulations applied to the current instance.
Эквивалент HTTP-состояния 507. Equivalent to HTTP status 507. InsufficientStorage указывает, что серверу не удается сохранить представление, необходимое для выполнения запроса. InsufficientStorage indicates that the server is unable to store the representation needed to complete the request.
Эквивалент HTTP-состояния 500. Equivalent to HTTP status 500. InternalServerError указывает, что на сервере произошла общая ошибка. InternalServerError indicates that a generic error has occurred on the server.
Эквивалент HTTP-состояния 411. Equivalent to HTTP status 411. LengthRequired указывает, что требуемый заголовок Content-Length отсутствует. LengthRequired indicates that the required Content-length header is missing.
Эквивалент HTTP-состояния 423. Equivalent to HTTP status 423. Locked указывает, что исходный или целевой ресурс заблокирован. Locked indicates that the source or destination resource is locked.
Эквивалент HTTP-состояния 508. Equivalent to HTTP status 508. LoopDetected указывает, что сервер прервал операцию, так как при обработке запроса WebDAV с «Depth: Infinity» был обнаружен бесконечный цикл. LoopDetected indicates that the server terminated an operation because it encountered an infinite loop while processing a WebDAV request with «Depth: infinity». Этот код состояния предназначен для обеспечения обратной совместимости с клиентами, не имеющими сведений о коде состояния 208 AlreadyReported, который отображается в теле ответа с несколькими состояниями. This status code is meant for backward compatibility with clients not aware of the 208 status code AlreadyReported appearing in multistatus response bodies.
Эквивалент HTTP-состояния 405. Equivalent to HTTP status 405. MethodNotAllowed указывает, что метод запроса (POST или GET) не разрешен для запрашиваемого ресурса. MethodNotAllowed indicates that the request method (POST or GET) is not allowed on the requested resource.
Эквивалент HTTP-состояния 421. Equivalent to HTTP status 421. MisdirectedRequest указывает, что запрос был направлен на сервер, который не может создать ответ. MisdirectedRequest indicates that the request was directed at a server that is not able to produce a response.
Эквивалент HTTP-состояния 301. Equivalent to HTTP status 301. Moved указывает, что запрашиваемые данные перемещены по универсальному коду ресурса (URI), заданному в заголовке Location. Moved indicates that the requested information has been moved to the URI specified in the Location header. Действие, выполняемое по умолчанию при получении этого состояния, состоит в отслеживании заголовка Location, связанного с ответом. The default action when this status is received is to follow the Location header associated with the response. Если для исходного запроса использовался метод POST, перенаправляемый запрос будет использовать метод GET. When the original request method was POST, the redirected request will use the GET method. Moved — синоним MovedPermanently . Moved is a synonym for MovedPermanently .
Эквивалент HTTP-состояния 301. Equivalent to HTTP status 301. MovedPermanently указывает, что запрашиваемые данные перемещены по универсальному коду ресурса (URI), заданному в заголовке Location. MovedPermanently indicates that the requested information has been moved to the URI specified in the Location header. Действие, выполняемое по умолчанию при получении этого состояния, состоит в отслеживании заголовка Location, связанного с ответом. The default action when this status is received is to follow the Location header associated with the response. MovedPermanently — синоним Moved . MovedPermanently is a synonym for Moved .
Эквивалент HTTP-состояния 300. Equivalent to HTTP status 300. MultipleChoices указывает, что запрашиваемые данные имеют несколько представлений. MultipleChoices indicates that the requested information has multiple representations. Действие, выполняемое по умолчанию, состоит в перенаправлении и отслеживании данных заголовка Location, связанного с этим ответом. The default action is to treat this status as a redirect and follow the contents of the Location header associated with this response. MultipleChoices — синоним Ambiguous . MultipleChoices is a synonym for Ambiguous .
Эквивалент HTTP-состояния 207. Equivalent to HTTP status 207. MultiStatus указывает несколько кодов состояния для одного ответа во время операции WebDAV. MultiStatus indicates multiple status codes for a single response during a Web Distributed Authoring and Versioning (WebDAV) operation. Текст ответа содержит XML-код, описывающий коды состояния. The response body contains XML that describes the status codes.
NetworkAuthenticationRequired
511
Эквивалент HTTP-состояния 511. Equivalent to HTTP status 511. NetworkAuthenticationRequired указывает, что клиенту необходимо пройти проверку подлинности, чтобы получить доступ к сети. Он предназначен для использования путем перехвата прокси-серверов, используемых для управления доступом к сети. NetworkAuthenticationRequired indicates that the client needs to authenticate to gain network access; it’s intended for use by intercepting proxies used to control access to the network.
Эквивалент HTTP-состояния 204. Equivalent to HTTP status 204. NoContent указывает, что запрос успешно обработан и ответ является преднамеренно пустым. NoContent indicates that the request has been successfully processed and that the response is intentionally blank.
NonAuthoritativeInformation
203
Эквивалент HTTP-состояния 203. Equivalent to HTTP status 203. NonAuthoritativeInformation указывает, что возвращенные метаданные взяты из кэшированной копии вместо исходного сервера и поэтому могут быть неверными. NonAuthoritativeInformation indicates that the returned metainformation is from a cached copy instead of the origin server and therefore may be incorrect.
Эквивалент HTTP-состояния 406. Equivalent to HTTP status 406. NotAcceptable указывает, что клиент показывает с помощью заголовков Accept, что он не принимает любые из доступных представлений ресурса. NotAcceptable indicates that the client has indicated with Accept headers that it will not accept any of the available representations of the resource.
Эквивалент HTTP-состояния 510. Equivalent to HTTP status 510. NotExtended указывает, что для выполнения серверу требуются дополнительные расширения запроса. NotExtended indicates that further extensions to the request are required for the server to fulfill it.
Эквивалент HTTP-состояния 404. Equivalent to HTTP status 404. NotFound указывает, что запрашиваемый ресурс отсутствует на сервере. NotFound indicates that the requested resource does not exist on the server.
Эквивалент HTTP-состояния 501. Equivalent to HTTP status 501. NotImplemented указывает, что сервер не поддерживает запрашиваемую функцию. NotImplemented indicates that the server does not support the requested function.
Эквивалент HTTP-состояния 304. Equivalent to HTTP status 304. NotModified указывает, что клиентская кэшированная копия является самой новой. NotModified indicates that the client’s cached copy is up to date. Данные ресурса не пересылаются. The contents of the resource are not transferred.
Эквивалент HTTP-состояния 200. Equivalent to HTTP status 200. OK указывает, что запрос завершился успешно и запрашиваемые данные находятся в ответе. OK indicates that the request succeeded and that the requested information is in the response. Это наиболее часто получаемый код состояния. This is the most common status code to receive.
Эквивалент HTTP-состояния 206. Equivalent to HTTP status 206. Значение PartialContent указывает, что ответ является частичным ответом на запрос GET, содержащий диапазон байтов. PartialContent indicates that the response is a partial response as requested by a GET request that includes a byte range.
Эквивалент HTTP-состояния 402. Equivalent to HTTP status 402. PaymentRequired зарезервирован для дальнейшего использования. PaymentRequired is reserved for future use.
Эквивалент HTTP-состояния 308. Equivalent to HTTP status 308. Значение PermanentRedirect указывает, что данные запроса расположены по универсальному коду ресурса (URI), заданному в заголовке Location. PermanentRedirect indicates that the request information is located at the URI specified in the Location header. Действие, выполняемое по умолчанию при получении этого состояния, состоит в отслеживании заголовка Location, связанного с ответом. The default action when this status is received is to follow the Location header associated with the response. Если для исходного запроса использовался метод POST, перенаправляемый запрос будет также использовать метод POST. When the original request method was POST, the redirected request will also use the POST method.
Эквивалент HTTP-состояния 412. Equivalent to HTTP status 412. PreconditionFailed указывает, что условие, установленное для этого запроса, не соблюдено и запрос не может быть выполнен. Условия задаются с помощью заголовков условного запроса, таких как If-Match, If-None-Match или If-Unmodified-Since. PreconditionFailed indicates that a condition set for this request failed, and the request cannot be carried out. Conditions are set with conditional request headers like If-Match, If-None-Match, or If-Unmodified-Since.
Эквивалент HTTP-состояния 428. Equivalent to HTTP status 428. PreconditionRequired указывает, что сервер требует, чтобы запрос был условным. PreconditionRequired indicates that the server requires the request to be conditional.
Эквивалент HTTP-состояния 102. Equivalent to HTTP status 102. Значение Processing указывает, что сервер принял весь запрос, но еще не выполнил его. Processing indicates that the server has accepted the complete request but hasn’t completed it yet.
ProxyAuthenticationRequired
407
Эквивалент HTTP-состояния 407. Equivalent to HTTP status 407. ProxyAuthenticationRequired указывает, что запрашиваемый прокси требует прохождения проверки подлинности. ProxyAuthenticationRequired indicates that the requested proxy requires authentication. В заголовке Proxy-authenticate подробно излагается порядок выполнения проверки подлинности. The Proxy-authenticate header contains the details of how to perform the authentication.
Эквивалент HTTP-состояния 302. Equivalent to HTTP status 302. Redirect указывает, что запрашиваемые данные расположены по универсальному коду ресурса (URI), заданному в заголовке Location. Redirect indicates that the requested information is located at the URI specified in the Location header. Действие, выполняемое по умолчанию при получении этого состояния, состоит в отслеживании заголовка Location, связанного с ответом. The default action when this status is received is to follow the Location header associated with the response. Если для исходного запроса использовался метод POST, перенаправляемый запрос будет использовать метод GET. When the original request method was POST, the redirected request will use the GET method. Redirect — синоним Found . Redirect is a synonym for Found .
Эквивалент HTTP-состояния 307. Equivalent to HTTP status 307. Значение RedirectKeepVerb указывает, что данные запроса расположены по универсальному коду ресурса (URI), заданному в заголовке Location. RedirectKeepVerb indicates that the request information is located at the URI specified in the Location header. Действие, выполняемое по умолчанию при получении этого состояния, состоит в отслеживании заголовка Location, связанного с ответом. The default action when this status is received is to follow the Location header associated with the response. Если для исходного запроса использовался метод POST, перенаправляемый запрос будет также использовать метод POST. When the original request method was POST, the redirected request will also use the POST method. RedirectKeepVerb — синоним TemporaryRedirect . RedirectKeepVerb is a synonym for TemporaryRedirect .
Эквивалент HTTP-состояния 303. Equivalent to HTTP status 303. Значение RedirectMethod приводит к автоматическому перенаправлению клиента на универсальный код ресурса (URI), заданный в заголовке Location, в результате выполнения запроса POST. RedirectMethod automatically redirects the client to the URI specified in the Location header as the result of a POST. Запрос ресурса, задаваемого заголовком Location, выполняется с помощью метода GET. The request to the resource specified by the Location header will be made with a GET. RedirectMethod — синоним SeeOther . RedirectMethod is a synonym for SeeOther .
RequestedRangeNotSatisfiable
416
Эквивалент HTTP-состояния 416. Equivalent to HTTP status 416. Значение RequestedRangeNotSatisfiable указывает, что диапазон данных, запрашиваемых из ресурса, не может быть возвращен из-за расположения начала диапазона до начала ресурса или конца диапазона после конца ресурса. RequestedRangeNotSatisfiable indicates that the range of data requested from the resource cannot be returned, either because the beginning of the range is before the beginning of the resource, or the end of the range is after the end of the resource.
Эквивалент HTTP-состояния 413. Equivalent to HTTP status 413. RequestEntityTooLarge указывает, что запрос слишком велик для сервера, чтобы быть обработанным. RequestEntityTooLarge indicates that the request is too large for the server to process.
RequestHeaderFieldsTooLarge
431
Эквивалент HTTP-состояния 431. Equivalent to HTTP status 431. RequestHeaderFieldsTooLarge указывает, что сервер не будет обрабатывать запрос, так как поля заголовка (отдельное поле заголовка или все поля заголовка) слишком велики. RequestHeaderFieldsTooLarge indicates that the server is unwilling to process the request because its header fields (either an individual header field or all the header fields collectively) are too large.
Эквивалент HTTP-состояния 408. Equivalent to HTTP status 408. RequestTimeout указывает, что клиент не послал запрос в пределах времени, когда запрос ожидался сервером. RequestTimeout indicates that the client did not send a request within the time the server was expecting the request.
Эквивалент HTTP-состояния 414. Equivalent to HTTP status 414. RequestUriTooLong указывает, что универсальный код ресурса (URI) слишком длинный. RequestUriTooLong indicates that the URI is too long.
Эквивалент HTTP-состояния 205. Equivalent to HTTP status 205. ResetContent указывает, что клиент должен сбросить (не перезагрузить) текущий ресурс. ResetContent indicates that the client should reset (not reload) the current resource.
Эквивалент HTTP-состояния 303. Equivalent to HTTP status 303. Значение SeeOther приводит к автоматическому перенаправлению клиента на универсальный код ресурса (URI), заданный в заголовке Location, в результате выполнения запроса POST. SeeOther automatically redirects the client to the URI specified in the Location header as the result of a POST. Запрос ресурса, задаваемого заголовком Location, выполняется с помощью метода GET. The request to the resource specified by the Location header will be made with a GET. SeeOther — синоним RedirectMethod SeeOther is a synonym for RedirectMethod
Эквивалент HTTP-состояния 503. Equivalent to HTTP status 503. Значение ServiceUnavailable указывает, что сервер временно недоступен, обычно из-за высокой нагрузки или выполняемого обслуживания. ServiceUnavailable indicates that the server is temporarily unavailable, usually due to high load or maintenance.
Эквивалент HTTP-состояния 101. Equivalent to HTTP status 101. SwitchingProtocols указывает, что изменяется протокол или версия протокола. SwitchingProtocols indicates that the protocol version or protocol is being changed.
Эквивалент HTTP-состояния 307. Equivalent to HTTP status 307. Значение TemporaryRedirect указывает, что данные запроса расположены по универсальному коду ресурса (URI), заданному в заголовке Location. TemporaryRedirect indicates that the request information is located at the URI specified in the Location header. Действие, выполняемое по умолчанию при получении этого состояния, состоит в отслеживании заголовка Location, связанного с ответом. The default action when this status is received is to follow the Location header associated with the response. Если для исходного запроса использовался метод POST, перенаправляемый запрос будет также использовать метод POST. When the original request method was POST, the redirected request will also use the POST method. TemporaryRedirect — синоним RedirectKeepVerb . TemporaryRedirect is a synonym for RedirectKeepVerb .
Эквивалент HTTP-состояния 429. Equivalent to HTTP status 429. TooManyRequests указывает, что пользователь отправил слишком много запросов за определенный период времени. TooManyRequests indicates that the user has sent too many requests in a given amount of time.
Эквивалент HTTP-состояния 401. Equivalent to HTTP status 401. Значение Unauthorized указывает, что для запрашиваемого ресурса требуется аутентификация. Unauthorized indicates that the requested resource requires authentication. В заголовке WWW-Authenticate подробно излагается порядок выполнения проверки подлинности. The WWW-Authenticate header contains the details of how to perform the authentication.
UnavailableForLegalReasons
451
Эквивалент HTTP-состояния 451. Equivalent to HTTP status 451. UnavailableForLegalReasons указывает, что сервер запрещает доступ к ресурсу в результате юридического требования. UnavailableForLegalReasons indicates that the server is denying access to the resource as a consequence of a legal demand.
Эквивалент HTTP-состояния 422. Equivalent to HTTP status 422. UnprocessableEntity указывает, что запрос имеет правильный формат, но был выполнен из-за семантических ошибок. UnprocessableEntity indicates that the request was well-formed but was unable to be followed due to semantic errors.
Эквивалент HTTP-состояния 415. Equivalent to HTTP status 415. UnsupportedMediaType указывает, что запрос этого типа не поддерживается. UnsupportedMediaType indicates that the request is an unsupported type.
Эквивалент HTTP-состояния 306. Equivalent to HTTP status 306. Unused является предлагаемым расширением спецификации HTTP/1.1, которая полностью не определена. Unused is a proposed extension to the HTTP/1.1 specification that is not fully specified.
Эквивалент HTTP-состояния 426. Equivalent to HTTP status 426. UpgradeRequired указывает, что клиент должен переключиться на другой протокол, например на TLS/1.0. UpgradeRequired indicates that the client should switch to a different protocol such as TLS/1.0.
Эквивалент HTTP-состояния 305. Equivalent to HTTP status 305. UseProxy указывает, что запрос должен использовать прокси-сервер по универсальному коду ресурса (URI), заданному в заголовке Location. UseProxy indicates that the request should use the proxy server at the URI specified in the Location header.
Эквивалент HTTP-состояния 506. Equivalent to HTTP status 506. VariantAlsoNegotiates указывает, что выбранный ресурс настроен для участия в прозрачном согласовании содержимого и, следовательно, не является подходящей конечной точкой для процесса согласования. VariantAlsoNegotiates indicates that the chosen variant resource is configured to engage in transparent content negotiation itself and, therefore, isn’t a proper endpoint in the negotiation process.
Примеры
В следующем примере сравнивается состояние, возвращенное HttpWebResponse с помощью члена HttpStatusCode класса, для определения состояния ответа. The following example compares the status returned by an HttpWebResponse with a member of the HttpStatusCode class to determine the status of a response.
Комментарии
HttpStatusCodeПеречисление содержит значения кодов состояния, определенных в RFC 2616 для HTTP 1,1. The HttpStatusCode enumeration contains the values of the status codes defined in RFC 2616 for HTTP 1.1.
Состояние HTTP-запроса содержится в HttpWebResponse.StatusCode свойстве. The status of an HTTP request is contained in the HttpWebResponse.StatusCode property. Если HttpWebRequest.AllowAutoRedirect свойство имеет значение false , следующие значения перечисления приводят к возникновению исключения: If the HttpWebRequest.AllowAutoRedirect property is false , the following enumeration values cause an exception to be thrown:
