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 を呼び出すと、表示名は解析名と同じになります。

要件