次の方法で共有

TranslateURLA 関数 (intshcut.h)

  • [アーティクル]

特定の URL 文字列に共通の翻訳を適用し、新しい URL 文字列を作成します。

構文

INTSHCUTAPI HRESULT TranslateURLA(
        PCSTR pcszURL,
        DWORD dwInFlags,
  [out] PSTR  *ppszTranslatedURL
);

パラメーター

pcszURL

型: PCTSTR

変換する URL 文字列のアドレス。

dwInFlags

型: DWORD

URL 文字列の変換方法を指定するビット フラグ。 この値には、次の組み合わせを指定できます。

TRANSLATEURL_FL_GUESS_PROTOCOL

TranslateURLを する pcszURL パラメーターでプロトコル スキームが指定されていない場合、システムはスキームを自動的に選択して URL に追加します。

TRANSLATEURL_FL_USE_DEFAULT_PROTOCOL

TranslateURLを する pcszURL パラメーターにプロトコル スキームが指定されていない場合、システムは既定のプロトコルを URL に追加します。

[out] ppszTranslatedURL

型: PTSTR*

新しく作成された変換された URL 文字列 (存在する場合) へのポインターを受け取るポインター変数。 ppszTranslatedURL パラメーターは、関数がS_OKを返す場合にのみ有効です。

戻り値

型: HRESULT

成功した場合はS_OKを返し、URL に翻訳が必要なかった場合はS_FALSEを返します。 エラーが発生した場合、関数は次のいずれかの値を返します。

リターン コード 形容
E_FLAGS
 dwInFlags 渡されたフラグの組み合わせが無効です。
E_OUTOFMEMORY
 操作を完了するためのメモリが不足していました。
E_POINTER
 入力ポインターの 1 つが無効です。

備考

この関数は、入力 URL 文字列を検証しません。 成功した戻り値は、URL 文字列が有効な URL であることを示すものではありません。

手記

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

必要条件

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