InternetCreateUrlA 関数 (wininet.h)

  • [アーティクル]

コンポーネント パーツから URL を作成します。

構文

BOOL InternetCreateUrlA(
  [in]      LPURL_COMPONENTSA lpUrlComponents,
  [in]      DWORD             dwFlags,
  [out]     LPSTR             lpszUrl,
  [in, out] LPDWORD           lpdwUrlLength
);

パラメーター

[in] lpUrlComponents

URL の作成元となるコンポーネントを含む URL_COMPONENTS 構造体へのポインター。

[in] dwFlags

この関数の操作を制御します。 このパラメーターには、次の 1 つ以上の値を指定できます。

値 意味
ICU_ESCAPE
 すべての安全でない文字を、lpszUrlPath メンバーが指すパス文字列内の対応するエスケープ シーケンスに変換し、lpszExtraInfo では lpUrlComponents パラメーターが指すURL_COMPONENTS構造体のメンバーが指す追加情報文字列に変換します。

InternetCreateUrl の Unicode バージョンでは、最初にシステム コード ページを使用して変換が試みられます。 失敗した場合は、UTF-8 にフォールバックします。
ICU_USERNAME
 現在は使用されていません。無視されます。

[out] lpszUrl

URL を受け取るバッファーへのポインター。

[in, out] lpdwUrlLength

URL lpszUrl バッファーのサイズを TCHAR で指定する変数へのポインター。 関数が戻ると、このパラメーターは NULL ターミネータを除く URL 文字列のサイズを受け取ります。 GetLastError がERROR_INSUFFICIENT_BUFFERを返す場合、このパラメーターは作成された URL を保持するために必要なバイト数を受け取ります。

戻り値

関数が成功した場合は TRUE 、それ以外の場合 は FALSE を 返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

lpUrlComponents に渡されるURL_COMPONENTS構造体でスキームを指定する場合、lpszScheme が NULL でない場合は、スキームに使用されます。 lpszScheme が NULL の場合、nScheme を必要なINTERNET_SCHEMEまたはINTERNET_SCHEME_DEFAULTに設定することで、INTERNET_SCHEME列挙を使用してスキームを指定できます。

メモ WinINet では、サーバーの実装はサポートされていません。 また、サービスから使用しないでください。 サーバーの実装またはサービスの場合は、 Microsoft Windows HTTP サービス (WinHTTP) を使用します。
 

注意

wininet.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして InternetCreateUrl を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wininet.h
Library Wininet.lib
[DLL] Wininet.dll

こちらもご覧ください

一様リソース ロケーターの処理

WinINet 関数