次の方法で共有


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 lpszExtraInfolpUrlComponents パラメーターが指す URL_COMPONENTS 構造体のメンバーが指す追加情報文字列に変換します。

InternetCreateUrl の Unicode バージョンは、まずシステム コード ページを使用して変換を試みます。 失敗した場合は UTF-8 にフォールバックします。

ICU_USERNAME
現在は使用されていません。無視されます。

[out] lpszUrl

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

[in, out] lpdwUrlLength

TCHAR内の lpszUrl バッファー URL のサイズを指定する変数へのポインター。 関数が戻るときに、このパラメーターは、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 Services (WinHTTP)を使用します。
 

手記

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

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー wininet.h
ライブラリ Wininet.lib
DLL Wininet.dll

関連項目

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

WinINet Functions の