IPStore::ReadItem 方法

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

从受保护的存储读取指定的数据项。

语法

HRESULT ReadItem(
  [in]       PST_KEY        Key,
  [in] const PSGUID         *pItemType,
  [in] const GUID           *pItemSubtype,
  [in]       LPCWSTR        *szItemName,
  [in]       DWORD          cbData,
  [in]       BYTE_RPC_FAR   *pbData,
  [in]       PPST_PROMPTIFO pPromptInfo,
  [in]       DWORD          dwFlags
);

参数

[in]

提供程序存储区域。

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

 

pItemType [in]

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

pItemSubtype [in]

指向 GUID 的指针,该 GUID 标识要读取的项的数据子类型。

szItemName [in]

指向字符串的指针,该字符串包含分配给存储的数据项的名称。

cbData [in]

一个 DWORD,指示包含存储的数据项的缓冲区的大小。

pbData [in]

指向包含存储的数据项的缓冲区的指针。

pPromptInfo [in]

指向 PST_PROMPTINFO 结构的指针。

dwFlags [in]

指定读取操作的用户界面和安全行为。

标志值可与逻辑 OR 组合使用。

含义
PST_UNRESTRICTED_ITEMDATA
0x00000004
指定数据流不安全。 默认情况下,项调用是安全的。
PST_PROMPT_QUERY
0x00000008
指定在成功时返回确认。 如果启用用户界面,则返回 成功PST_E_OK 。 如果未启用用户界面,则返回 值 PST_E_ITEM_EXISTS
PST_NO_UI_MIGRATION
0x00000010
除非需要自定义密码,否则不显示用户界面。

 

返回值

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

备注

如果 ReadItem 成功完成,则应用程序负责使用 CoTaskMemFree 函数释放返回的数据缓冲区。

要求

要求
标头
Pstore.h
DLL
Pstorec.dll

另请参阅

IPStore

PST_PROMPTINFO