Funzione HttpInitialize (http.h)

  • Articolo

La funzione HttpInitialize inizializza il driver API server HTTP, la avvia, se non è già stata avviata e alloca strutture di dati per l'applicazione chiamante per supportare la creazione della coda di risposta e altre operazioni. Chiamare questa funzione prima di chiamare qualsiasi altra funzione nell'API server HTTP.

Sintassi

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

Parametri

[in] Version

Versione HTTP. Questo parametro è una struttura HTTPAPI_VERSION . Per la versione corrente dichiarare un'istanza della struttura e impostarla sul valore pre-definito HTTPAPI_VERSION_1 prima di passarla a HttpInitialize.

[in] Flags

Opzioni di inizializzazione, che possono includere uno o entrambi i valori seguenti.

Valore Significato
HTTP_INITIALIZE_CONFIG
 Eseguire l'inizializzazione per le applicazioni che usano le funzioni di configurazione HTTP, HttpSetServiceConfiguration, HttpQueryServiceConfiguration, HttpDeleteServiceConfiguration e HttpIsFeatureSupported.
HTTP_INITIALIZE_SERVER
 Eseguire l'inizializzazione per le applicazioni che usano l'API server HTTP.

[in, out] pReserved

Questo parametro è riservato e deve essere NULL.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Valore Significato
ERROR_INVALID_PARAMETER
 Il parametro Flags contiene un valore non supportato.
Altri
 Codice di errore di sistema definito in WinError.h.

Commenti

Chiamare HttpTerminate al termine dell'applicazione. Tutti gli stessi flag passati a HttpInitialize nel parametro Flags devono essere passati anche a HttpTerminate. Un'applicazione può chiamare ripetutamente HttpInitialize , purché ogni chiamata a HttpInitialize sia successivamente corrispondente a una chiamata a HttpTerminate.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione http.h
Libreria Httpapi.lib
DLL Httpapi.dll

Vedi anche