IMFHttpDownloadRequest::GetURL 方法 (mfidl.h)
傳回用來傳送要求的 URL。
語法
HRESULT GetURL(
[out] LPWSTR *ppszURL
);
參數
[out] ppszURL
用來將要求傳送至伺服器的URL。 請注意,如果伺服器已發出 HTTP 通訊協定「重新導向」,此 URL 可能會不同。 pszURL 的記憶體必須配置 CoTaskMemAlloc,且媒體基礎會使用 CoTaskMemFree 釋出。
傳回值
方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。
傳回碼 | 描述 |
---|---|
|
已成功傳回 URL。 |
|
記憶體不足,無法完成作業。 |
|
ppszURL 參數是無效的指標。 |
備註
根據預設, GetURL 會傳回從 IMFHttpDownloadSession::SetServer 和 IMFHttpDownloadSession::CreateRequest 方法中 Media Foundation 所提供的參數合成的 URL。 不過,如果 HTTP 伺服器已將 IMFHttpDownloadRequest 重新導向至不同的伺服器 (亦即,透過 “302 See Other” HTTP 回應) GetURL 方法會傳回 HTTP 伺服器指定的 URL。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 10 版本 1703 [僅限傳統型應用程式] |
最低支援的伺服器 | 都不支援 |
目標平台 | Windows |
標頭 | mfidl.h |
程式庫 | Mfplat.lib;Mfplat.dll |