次の方法で共有

TranslateURLW 関数 (intshcut.h)

  • [アーティクル]

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

構文

INTSHCUTAPI HRESULT TranslateURLW(
        PCWSTR pcszURL,
        DWORD  dwInFlags,
  [out] PWSTR  *ppszTranslatedURL
);

パラメーター

pcszURL

種類: PCTSTR

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

dwInFlags

型: DWORD

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

TRANSLATEURL_FL_GUESS_PROTOCOL

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

TRANSLATEURL_FL_USE_DEFAULT_PROTOCOL

PcszURL パラメーターで TranslateURL にプロトコル スキームが指定されていない場合、システムは既定のプロトコルを 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 であることを示すものではありません。

Note

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

要件

   
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー intshcut.h
[DLL] Url.dll