Metodo IMFHttpDownloadRequest::QueryHeader (mfidl.h)

Articolo
08/24/2023

Richiamato da Microsoft Media Foundation per recuperare i valori delle intestazioni HTTP specificate dalla risposta a una richiesta HTTP o HTTPS inviata in precedenza. Media Foundation richiama questo metodo solo dopo aver richiamato correttamente il metodo EndReceiveResponse .

Sintassi

HRESULT QueryHeader(
  [in]  LPCWSTR szHeaderName,
  [in]  DWORD   dwIndex,
  [out] LPWSTR  *ppszHeaderValue
);

Parametri

[in] szHeaderName

Nome dell'intestazione HTTP per cui viene eseguita una query sul valore.

[in] dwIndex

Numero di indice dell'intestazione specificata, per il caso in cui la risposta contiene più intestazioni con lo stesso nome. Il valore 0 indica che viene richiesto il valore della prima intestazione con il nome specificato, 1 indica che è richiesta la seconda intestazione e così via.

[out] ppszHeaderValue

Impostare sul valore dell'intestazione richiesta, senza includere i caratteri di ritorno a capo o avanzamento riga. La memoria per ppszHeaderValue deve essere allocata con CoTaskMemAlloc e verrà liberata da Media Foundation con CoTaskMemFree.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	È stato restituito correttamente il valore dell'intestazione specificata con l'indice specificato.
E_OUTOFMEMORY	Memoria insufficiente per completare l'operazione.
E_POINTER	Il parametro ppszHeaderValue è un puntatore non valido.
MF_E_OUT_OF_RANGE	Il valore del parametro dwIndex non è compreso nell'intervallo.

Requisiti


Client minimo supportato	Windows 10 versione 1703 [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	mfidl.h
Libreria	Mfplat.lib; Mfplat.dll

Vedi anche

IMFHttpDownloadRequest

Condividi tramite