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 函数释放返回的数据缓冲区。
要求 | 值 |
---|---|
标头 |
|
DLL |
|