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

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

構文

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

[in] psi

IShellItem へのポインター。

[in] grfMode

型: DWORD

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

IShellItem は読み取り専用です。

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

型: HRESULT

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

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

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