IMFHttpDownloadRequest::GetURL メソッド (mfidl.h)

要求の送信に使用される URL を返します。

構文

HRESULT GetURL(
  [out] LPWSTR *ppszURL
);

パラメーター

[out] ppszURL

要求をサーバーに送信するために使用される URL。 サーバーが HTTP プロトコル "リダイレクト" を発行した場合、この URL は異なる場合があることに注意してください。 pszURL のメモリは CoTaskMemAlloc で割り当てる必要があり、CoTaskMemFree を使用して Media Foundation によって解放されます。

戻り値

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

リターン コード	説明
S_OK	URL が正常に返されました。
E_OUTOFMEMORY	操作を完了するためのメモリが不足しています。
E_POINTER	ppszURL パラメーターは無効なポインターです。

注釈

既定では、GetURL は、IMFHttpDownloadSession::SetServer メソッドおよび IMFHttpDownloadSession::CreateRequest メソッドの Media Foundation によって提供されるパラメーターから合成された URL を返します。 ただし、HTTP サーバーが IMFHttpDownloadRequest を別のサーバー (つまり、"302 See Other" HTTP 応答を介して) にリダイレクトした場合、 GetURL メソッドは HTTP サーバーが指定した URL を返します。

要件

要件	値
サポートされている最小のクライアント	Windows 10、バージョン 1703 [デスクトップ アプリのみ]
サポートされている最小のサーバー	サポートなし
対象プラットフォーム	Windows
ヘッダー	mfidl.h
Library	Mfplat.lib;Mfplat.dll

こちらもご覧ください

IMFHttpDownloadRequest