IAttachmentExecute::SetFileName メソッド (shobjidl_core.h)

ファイルの提案された名前を指定して格納します。

構文

HRESULT SetFileName(
  [in] LPCWSTR pszFileName
);

[in] pszFileName

種類: LPCWSTR

ファイル名を含む文字列へのポインター。

型: HRESULT

このメソッドは、成功すると S_OK を返します。それ以外の場合は、次のような HRESULT エラーコードが返されます。

リターンコード	説明
E_INVALIDARG	pszFileName の値は NULL に設定され、空の文字列を指すか、MAX_PATHより長いファイル名を指します。
E_UNEXPECTED	ファイル名を格納できません。

pszFileName にはパス情報を含めず、ファイルの名前だけを含める必要があります。

IAttachmentExecute::SetFileName は、ファイルをローカルにコピーする前に、呼び出し元のアプリケーションがファイル名の有効性をチェックするために使用できます。ファイル名は、ローカルパスの場所に格納されている他のファイルとの名前の競合を確認します。

IAttachmentExecute::SetFileName は省略可能です。


サポートされている最小のクライアント	WINDOWS XP と SP2 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	shobjidl_core.h (Shobjidl.h を含む)
[DLL]	Shdocvw.dll (バージョン 6.0 以降)