InternetCreateUrlW

構成要素から URL を作成する。(Unicode)

InternetCreateUrlW lpUrlComponents, dwFlags, lpszUrl, lpdwUrlLength

lpUrlComponents : [var] URL を作成するための構成要素を格納した URL_COMPONENTS 構造体へのポインタ。
dwFlags : [int] 
lpszUrl : [wstr] URL を受け取るバッファへのポインタ。
lpdwUrlLength : [var] URL lpszUrl バッファのサイズ (TCHAR 単位) を指定する変数へのポインタ。関数が戻ると、本パラメータには URL 文字列のサイズ (NULL 終端を除く) が格納される。GetLastError が ERROR_INSUFFICIENT_BUFFER を返した場合、本パラメータには作成された URL を保持するために必要なバイト数が格納される。

(プラグイン / モジュール : wininet.dll)

解説

構成要素から URL を作成する。(Unicode)

[戻り値]
関数が成功した場合は TRUE を、失敗した場合は FALSE を返す。拡張エラー情報を取得するには GetLastError
を呼び出す。

[備考]
lpUrlComponents に渡す URL_COMPONENTS 構造体でスキームを指定する場合、lpszScheme が NULL
でなければそれがスキームとして使用される。lpszScheme が NULL の場合、nScheme に必要な
INTERNET_SCHEME 値または INTERNET_SCHEME_DEFAULT を設定することで、INTERNET_SCHEME
列挙を使用してスキームを指定できる。注意: WinINet
はサーバー実装をサポートしていない。さらに、サービスから使用すべきでもない。サーバー実装やサービスでは Microsoft Windows
HTTP Services (WinHTTP) を使用すること。
> [!NOTE] > wininet.h ヘッダーは InternetCreateUrl をエイリアスとして定義しており、UNICODE
プリプロセッサ定数の定義に基づいて本関数の ANSI 版または Unicode
版を自動的に選択する。エンコーディング中立のエイリアスとエンコーディング中立でないコードを混在させると、コンパイルエラーや実行時エラーの原因となるミスマッチが発生する可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報