Metodo IBackgroundCopyJobHttpOptions::GetCustomHeaders (bits2_5.h)
Recupera le intestazioni personalizzate impostate da una chiamata precedente a IBackgroundCopyJobHttpOptions::SetCustomHeaders , ovvero le intestazioni che BITS invieranno al remoto, non le intestazioni ricevute da BITS dal remoto.
Sintassi
HRESULT GetCustomHeaders(
[out] LPWSTR *pRequestHeaders
);
Parametri
[out] pRequestHeaders
Stringa con terminazione Null contenente le intestazioni personalizzate. Ogni intestazione viene terminata da un carattere ritorno a capo e avanzamento riga (CR/LF). Per liberare la stringa al termine, chiamare la funzione CoTaskMemFree .
Valore restituito
Nella tabella seguente sono elencati alcuni dei possibili valori restituiti.
| Codice restituito | Descrizione |
|---|---|
|
Sono state recuperate correttamente le intestazioni. |
|
Il processo non specifica intestazioni personalizzate. |
|
Non si dispone dell'autorizzazione per recuperare le intestazioni personalizzate o [IBackgroundCopyJobHttpOptions3::MakeCustomHeadersWriteOnly](/windows/desktop/api/bits10_3/nf-bits10_3-ibackgroundcopyjobhttpoptions3-makecustomheaderswriteonly) è stata chiamata sul processo. |
|
Il parametro pRequestHeaders è NULL. |
Commenti
Solo il proprietario del processo può recuperare le intestazioni personalizzate. Per specificare le intestazioni, chiamare il metodo IBackgroundCopyJobHttpOptions::SetCustomHeaders .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | bits2_5.h (include Bits.h) |
| Libreria | Bits.lib |