IPStore::OpenItem 方法

[受保护的存储 (Pstore) 可用于 Windows Server 2003 和 Windows XP。 它仅适用于 Windows Server 2008 和 Windows Vista 中的只读操作,但在后续版本中可能不可用。 Pstore 使用较旧的数据保护实现。 强烈建议开发人员利用 CryptProtectData 和 CryptUnprotectData 函数提供的更强大的数据保护。]

打开一个项进行多次访问。

语法

HRESULT OpenItem(
  [in]       PST_KEY        Key,
  [in] const PSGUID         *pItemType,
  [in] const GUID           *pItemSubtype,
  [in]       LPCWSTR        *szItemName,
  [in]       PST_ACCESSMODE ModeFlags,
  [in]       PPST_PROMPTIFO pProomptInfo,
  [in]       DWORD          dwFlags
);

参数

[in]

指定类型是计算机本地类型还是仅与创建用户关联。

含义
PST_KEY_CURRENT_USER
0x00000000
存储保留在注册表的当前用户部分中。
PST_KEY_LOCAL_MACHINE
0x00000001
存储保留在注册表的本地计算机部分中。

 

pItemType [in]

指向 GUID 的指针,该 GUID 标识要打开的项的数据类型。

pItemSubtype [in]

指向 GUID 的指针,该 GUID 指示要打开的项子类型。

szItemName [in]

一个字符串,其中包含要打开的项的名称。

ModeFlags [in]

描述一组指定的访问子句所涉及的访问模式。 有关详细信息,请参阅 PStore 类型

含义
PST_READ
0x0001
读取访问模式。
PST_WRITE
0x0002
写入访问模式。

 

pProomptInfo [in]

指向 PST_PROMPTINFO 结构的指针。

dwFlags [in]

保留:必须设置为零。

返回值

返回值为 HRESULT 值。 值为 PST_E_OK 表示函数成功。

备注

使用 OpenItem 打开受保护存储数据库中的项需要最终使用 IPStore::CloseItem 将其关闭,以防止内存泄漏。

要求

要求
标头
Pstore.h
DLL
Pstorec.dll

另请参阅

IPStore

PST_PROMPTINFO