Función HttpInitialize (http.h)

  • Artículo

La función HttpInitialize inicializa el controlador de API de SERVIDOR HTTP, lo inicia, si aún no se ha iniciado y asigna estructuras de datos para que la aplicación que realiza la llamada admita la creación de colas de respuestas y otras operaciones. Llame a esta función antes de llamar a cualquier otra función de la API del servidor HTTP.

Sintaxis

HTTPAPI_LINKAGE ULONG HttpInitialize(
  [in]      HTTPAPI_VERSION Version,
  [in]      ULONG           Flags,
  [in, out] PVOID           pReserved
);

Parámetros

[in] Version

Versión HTTP. Este parámetro es una estructura de HTTPAPI_VERSION . Para la versión actual, declare una instancia de la estructura y establézcala en el valor predefinido HTTPAPI_VERSION_1 antes de pasarla a HttpInitialize.

[in] Flags

Opciones de inicialización, que pueden incluir uno o ambos de los valores siguientes.

Valor Significado
HTTP_INITIALIZE_CONFIG
 Realice la inicialización de las aplicaciones que usan las funciones de configuración HTTP, HttpSetServiceConfiguration, HttpQueryServiceConfiguration, HttpDeleteServiceConfiguration y HttpIsFeatureSupported.
HTTP_INITIALIZE_SERVER
 Realice la inicialización para las aplicaciones que usan la API del servidor HTTP.

[in, out] pReserved

Este parámetro está reservado y debe ser NULL.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto se NO_ERROR.

Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.

Valor Significado
ERROR_INVALID_PARAMETER
 El parámetro Flags contiene un valor no admitido.
Otros
 Código de error del sistema definido en WinError.h.

Comentarios

Llame a HttpTerminate cuando se complete la aplicación. Todas las mismas marcas que se pasaron a HttpInitialize en el parámetro Flags también deben pasarse a HttpTerminate. Una aplicación puede llamar a HttpInitialize repetidamente, siempre que cada llamada a HttpInitialize coincida posteriormente con una llamada correspondiente a HttpTerminate.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado http.h
Library Httpapi.lib
Archivo DLL Httpapi.dll

Consulte también