Condividi tramite


Metodo IXMLHTTPRequest2::SetProperty (msxml6.h)

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

Vedi anche

IXMLHTTPRequest2

IXMLHTTPRequest3

OnHeadersAvailable

Apri

Enumerazione XHR_PROPERTY