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

要件

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