IInitializeWithItem::Initialize メソッド (shobjidl_core.h)

  • [アーティクル]

IShellItem を使用してハンドラーを初期化します。

構文

HRESULT Initialize(
  [in] IShellItem *psi,
  [in] DWORD      grfMode
);

パラメーター

[in] psi

種類: IShellItem*

IShellItem へのポインター。

[in] grfMode

型: DWORD

psi のアクセス モードを示す次のいずれかの STGM 値。

STGM_READ

IShellItem は読み取り専用です。

STGM_READWRITE

IShellItem は読み取り/書き込みアクセス可能です。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

IShellItem にアクセスできない場合、このメソッドは適切なエラー コードを返します。

ハンドラー インスタンスは、有効期間内に 1 回だけ初期化する必要があります。 呼び出し元のアプリケーションがハンドラーを再初期化しようとすると、エラー が発生 HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)します。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー shobjidl_core.h (Propsys.h を含む)