Funzione HttpAddUrl (http.h)
La funzione HttpAddUrl registra un URL specificato in modo che le richieste corrispondenti vengano indirizzate a una coda di richiesta API HTTP Server specificata. Un'applicazione può registrare più URL in una singola coda di richieste usando chiamate ripetute a HttpAddUrl. Per altre informazioni sul modo in cui l'API server HTTP corrisponde agli URL di richiesta agli URL registrati, vedere UrlPrefix Strings.
A partire dall'API HTTP Server versione 2.0, le applicazioni devono chiamare HttpAddUrlToUrlGroup per registrare un URL; HttpAddUrl non deve essere usato.
Sintassi
HTTPAPI_LINKAGE ULONG HttpAddUrl(
[in] HANDLE RequestQueueHandle,
[in] PCWSTR FullyQualifiedUrl,
PVOID Reserved
);
Parametri
[in] RequestQueueHandle
Handle alla coda di richiesta a cui devono essere indirizzate le richieste per l'URL specificato. Viene creata una coda di richieste e il relativo handle restituito da una chiamata alla funzione HttpCreateRequestQueue .
Windows Server 2003 con SP1 e Windows XP con SP2: L'handle della coda della richiesta viene creato dalla funzione HttpCreateHttpHandle .
[in] FullyQualifiedUrl
Puntatore a una stringa Unicode contenente una stringa UrlPrefix corretta che identifica l'URL da registrare.
Reserved
Riservati; 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 |
|---|---|
|
L'applicazione chiamante non dispone dell'autorizzazione per registrare l'URL. |
|
L'applicazione chiamante non ha chiamato HttpInitialize prima di chiamare questa funzione. |
|
Uno dei parametri non è valido. |
|
UrlPrefix specificato è in conflitto con una registrazione esistente. |
|
Risorse insufficienti per completare l'operazione. |
|
Codice di errore di sistema definito in WinError.h. |
Commenti
Come indicato nell'argomento Stringhe urlPrefix , la specifica dello schema dell'URLPrefix da registrare deve essere "http" in minuscolo o "https". Nessun'altra sottostringa è valida.
Inoltre, non è possibile registrare GLI URL con schemi diversi nella stessa porta. Ovvero, gli schemi "http" e "https" non possono coesistere in una porta.
Tenere presente anche che HttpAddUrl registra qualsiasi urlPrefix passato a esso purché la stringa sia ben formata. Qualsiasi convalida di esistenza, accessibilità, proprietà o altra caratteristica dello spazio dei nomi URL specificato deve essere gestito dall'applicazione.
Per rilasciare le risorse allocate come risultato della registrazione eseguita da HttpAddUrl, effettuare una chiamata corrispondente alla funzione HttpRemoveUrl al termine dell'applicazione con lo spazio dei nomi coinvolto.
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 |