IInitializeWithItem::Initialize 方法 (shobjidl_core.h)

使用 IShellItem 初始化处理程序。

语法

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

参数

[in] psi

类型: IShellItem*

指向 IShellItem 的指针。

[in] grfMode

类型:DWORD

以下 STGM 值之一,指示 psi 的访问模式。

STGM_READ

IShellItem 是只读的。

STGM_READWRITE

IShellItem 可读写。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

如果无法访问 IShellItem ,此方法将返回相应的错误代码。

处理程序实例在其生存期内应只初始化一次。 调用应用程序尝试重新初始化处理程序会导致错误 HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Propsys.h)