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
S_OK	Sono state recuperate correttamente le intestazioni.
S_FALSE	Il processo non specifica intestazioni personalizzate.
E_ACCESSDENIED	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.
RPC_X_NULL_REF_POINTER	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

Vedi anche

IBackgroundCopyJobHttpOptions

IBackgroundCopyJobHttpOptions::SetCustomHeaders