SHSetLocalizedName 関数 (shellapi.h)

シェル フォルダー内のファイルのローカライズされた名前を設定します。

構文

SHSTDAPI SHSetLocalizedName(
  [in] PCWSTR pszPath,
  [in] PCWSTR pszResModule,
       int    idsRes
);

パラメーター

[in] pszPath

種類: PCWSTR

ターゲット ファイルの完全修飾パスを指定する文字列へのポインター。

[in] pszResModule

種類: PCWSTR

ファイル名のローカライズされたバージョンを指定する文字列リソースへのポインター。

idsRes

型: int

文字列リソース内のローカライズされたファイル名を指定する整数 ID。

戻り値

型: HRESULT

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

解説

この文字列を設定すると、エクスプローラーはファイル名の代わりにこの文字列を表示します。 ファイルへのパスは変更されません。

アプリケーションは、IShellFolder::GetDisplayNameOf の表示 (ローカライズされた) 名を SIGDN_NORMALDISPLAY フラグで取得し、SIGDN_DESKTOPABSOLUTEPARSING フラグを使用して IShellItem::GetDisplayName を使用して解析 (ローカライズされていない) 名前を取得できます。

SHRemoveLocalizedName を呼び出すと、表示名は解析名と同じになります。

要件

サポートされている最小のクライアント	Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	shellapi.h
[DLL]	Shell32.dll;Shell32.dll (バージョン 5.6 以降)
API セット	ext-ms-win-shell-shell32-l1-2-0 (Windows 8.1 で導入)