Metodo IXMLHTTPRequest2::SetProperty (msxml6.h)

Articolo
08/25/2023

Imposta una proprietà su una richiesta HTTP in uscita.

Sintassi

HRESULT SetProperty(
  [in] XHR_PROPERTY eProperty,
  [in] ULONGLONG    ullValue
);

Parametri

[in] eProperty

I valori seguenti sono validi:

Valore	Significato
XHR_PROP_NO_CRED_PROMPT	Elimina le richieste automatiche per le credenziali utente
XHR_PROP_NO_AUTH	Elimina l'autenticazione eseguita dallo stack HTTP per conto dell'applicazione
XHR_PROP_TIMEOUT	Imposta tutti i valori di timeout sul valore specificato da ullValue, espresso in millisecondi.
XHR_PROP_NO_DEFAULT_HEADERS	Elimina l'aggiunta di intestazioni predefinite alla richiesta HTTP.
XHR_PROP_REPORT_REDIRECT_STATUS	Fa sì che lo stack HTTP chiami il metodo OnHeadersAvailable con un codice di stato di reindirizzamento provvisorio. Il metodo OnHeadersAvailable verrà chiamato di nuovo per reindirizzamenti aggiuntivi e il codice di stato di destinazione finale.
XHR_PROP_NO_CACHE	Elimina le letture e le scritture della cache per la richiesta HTTP. Questa proprietà è supportata dall'interfaccia IXMLHTTPRequest3 .
XHR_PROP_EXTENDED_ERROR	Fa sì che lo stack HTTP fornisca HRESULTS con il codice di errore Win32 sottostante al metodo OnError in caso di errore. Questa proprietà è supportata dall'interfaccia IXMLHTTPRequest3 .
XHR_PROP_QUERY_STRING_UTF8	Fa sì che la stringa di query venga codificata in UTF-8 anziché ACP per la richiesta HTTP. Questa proprietà è supportata dall'interfaccia IXMLHTTPRequest3 .
XHR_PROP_IGNORE_CERT_ERRORS	Elimina alcuni errori del certificato. Questa proprietà è supportata dall'interfaccia IXMLHTTPRequest3 .

[in] ullValue

Specifica il numero di millisecondi di attesa dell'applicazione prima del timeout.

Valore	Significato
XHR_PROP_NO_CRED_PROMPT	Questo parametro può essere uno dei valori del tipo di enumerazione XHR_CRED_PROMPT definito nel file di intestazione Msxml6.h . XHR_CRED_PROMPT_ALL se la richiesta di credenziali deve essere abilitata (impostazione predefinita). XHR_CRED_PROMPT_NONE se la richiesta di credenziali deve essere disabilitata. XHR_CRED_PROMPT_PROXY se la richiesta di credenziali deve essere abilitata solo per l'autenticazione proxy.
XHR_PROP_NO_AUTH	Questo parametro può essere uno dei valori del tipo di enumerazione XHR_AUTH definito nel file di intestazione Msxml6.h . XHR_AUTH_ALL se l'autenticazione è abilitata (impostazione predefinita). XHR_AUTH_NONE se l'autenticazione è disabilitata. XHR_AUTH_PROXY se l'autenticazione deve essere abilitata solo per l'autenticazione proxy.
XHR_PROP_TIMEOUT	Numero di millisecondi, fino a 0xFFFFFFFF, che l'app attende prima del timeout.
XHR_PROP_NO_DEFAULT_HEADERS	FALSE(0x0) per abilitare l'aggiunta di intestazioni predefinite (impostazione predefinita). TRUE(0x1) per disabilitare l'aggiunta di intestazioni predefinite.
XHR_PROP_REPORT_REDIRECT_STATUS	FALSE(0x0) per non segnalare lo stato di reindirizzamento (impostazione predefinita). TRUE(0x1) per segnalare lo stato di reindirizzamento.
XHR_PROP_NO_CACHE	FALSE(0x0) per abilitare la memorizzazione nella cache (impostazione predefinita). TRUE(0x1) per disabilitare la memorizzazione nella cache.
XHR_PROP_EXTENDED_ERROR	FALSE(0x0) per non fornire errori estesi (impostazione predefinita). TRUE(0x1) per fornire errori estesi.
XHR_PROP_QUERY_STRING_UTF8	FALSE(0x0) per non codificare la stringa di query in UTF-8 (impostazione predefinita). TRUE(0x1) per codificare la stringa di query in UTF-8.
XHR_PROP_IGNORE_CERT_ERRORS	FALSE(0x0) per non ignorare gli errori del certificato (impostazione predefinita). TRUE(0x1) per ignorare gli errori del certificato.

Valore restituito

Restituisce S_OK in caso di esito positivo.

Commenti

Il metodo SetProperty nell'interfaccia IXMLHTTPRequest2 viene esteso nell'interfaccia IXMLHTTPRequest3 con nuove proprietà per supportare nuovi scenari:

XHR_PROP_NO_CACHE: elimina le letture e le scritture della cache per la richiesta HTTP.
XHR_PROP_EXTENDED_ERROR: fa sì che lo stack HTTP fornisca HRESULTS con il codice di errore Win32 sottostante al metodo OnError in caso di errore.
XHR_PROP_QUERY_STRING_UTF8: fa sì che la stringa di query venga codificata in UTF-8 anziché ACP per la richiesta HTTP.
XHR_PROP_IGNORE_CERT_ERRORS: elimina determinati errori del certificato del server.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [app desktop \| App UWP],MSXML 6.0 e versioni successive
Server minimo supportato	Windows Server 2012 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	msxml6.h