次の方法で共有

InternetCombineUrlA 関数 (wininet.h)

  • [アーティクル]

ベース URL と相対 URL を 1 つの URL に結合します。 結果の URL は正規化されます (internetCanonicalizeUrl参照)。

構文

BOOL InternetCombineUrlA(
  [in]      LPCSTR  lpszBaseUrl,
  [in]      LPCSTR  lpszRelativeUrl,
  [out]     LPSTR   lpszBuffer,
  [in, out] LPDWORD lpdwBufferLength,
  [in]      DWORD   dwFlags
);

パラメーター

[in] lpszBaseUrl

ベース URL を含む null で終わる文字列へのポインター。

[in] lpszRelativeUrl

相対 URL を含む null で終わる文字列へのポインター。

[out] lpszBuffer

結合された URL を受け取るバッファーへのポインター。

[in, out] lpdwBufferLength

lpszBuffer バッファーのサイズを含む変数へのポインター (文字単位)。 関数が成功した場合、このパラメーターは、null 終端文字を含まない、結合された URL のサイズを文字で受け取ります。 関数が失敗した場合、このパラメーターは必要なバッファーのサイズ (null 終端文字を含む) を文字で受け取ります。

[in] dwFlags

関数の操作を制御します。 このパラメーターには、次のいずれかの値を指定できます。

価値 意味
ICU_BROWSER_MODE
 "#" または "?"" の後の文字はエンコードまたはデコードされず、"?"" の後の末尾の空白は削除されません。 この値を指定しない場合、URL 全体がエンコードされ、末尾の空白が削除されます。
ICU_DECODE
 URL が解析される前に、すべての %XX シーケンスをエスケープ シーケンスを含む文字に変換します。
ICU_ENCODE_PERCENT
 発生したパーセント記号をエンコードします。 既定では、パーセント記号はエンコードされません。 この値は、Microsoft Internet Explorer 5 以降で使用できます。
ICU_ENCODE_SPACES_ONLY
 スペースのみをエンコードします。
ICU_NO_ENCODE
 安全でない文字をエスケープ シーケンスに変換しません。
ICU_NO_META
 URL からメタ シーケンス ("." や ".." など) を削除しません。

戻り値

成功した場合 TRUE を返し、それ以外の場合は FALSE 返します。 拡張エラー情報を取得するには、GetLastError呼び出します。 考えられるエラーは次のとおりです。

リターン コード 形容
ERROR_BAD_PATHNAME
 URL を結合できませんでした。
ERROR_INSUFFICIENT_BUFFER
 関数に指定されたバッファーが不十分であるか、NULL。 lpdwBufferLength パラメーターによって示される値には、結合された URL を保持するために必要なバイト数が含まれます。
ERROR_INTERNET_INVALID_URL
 URL の形式が無効です。
ERROR_INVALID_PARAMETER
 無効な文字列、バッファー、バッファー サイズ、またはフラグ パラメーターがあります。

備考

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

手記

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

必要条件

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

関連項目

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

WinINet Functions の