IPStore::WriteItem 方法
[受保护的存储 (Pstore) 可用于 Windows Server 2003 和 Windows XP。 它仅适用于 Windows Server 2008 和 Windows Vista 中的只读操作,但在后续版本中可能不可用。 Pstore 使用数据保护的旧实现。 强烈建议开发人员利用 CryptProtectData 和 CryptUnprotectData 函数提供的更强大的数据保护。
将数据项写入受保护的存储。
语法
HRESULT WriteItem(
[in] PST_KEY Key,
[in] const GUID *pItemType,
[in] const GUID *pItemSubtype,
[in] LPCWSTR *szItemName,
[out] DWORD *cbData,
[out] BYTE ppbData,
[in] PPST_PROMPTIFO pProomptInfo,
[in] DWORD dwDefaultConfirmationStyle,
[in] DWORD dwFlags
);
parameters
-
键 [in]
-
提供程序存储区域。
值 含义 - PST_KEY_CURRENT_USER
- 0x00000000
存储在注册表的当前用户部分中维护。 - PST_KEY_LOCAL_MACHINE
- 0x00000001
存储保留在注册表的本地计算机部分中。 -
pItemType [in]
-
指向 GUID 的指针,该 GUID 标识所写入的数据项的数据类型。
-
pItemSubtype [in]
-
指向 GUID 的指针,该 GUID 标识正在写入的数据项的数据子类型。
-
szItemName [in]
-
指向字符串的指针,该字符串包含分配给存储的数据项的名称。
-
cbData [out]
-
指向 DWORD 的指针,指示包含存储数据项的缓冲区的大小。
-
ppbData [out]
-
指向包含正在写入的数据项的缓冲区的指针。
-
pProomptInfo [in]
-
指向 PST_PROMPTINFO 结构的指针。
-
dwDefaultConfirmationStyle [in]
-
默认确认样式。
值 含义 - PST_CF_DEFAULT
- 0x00000000
允许用户选择确认样式。 - PST_CF_NONE
- 0x00000001
强制创建无提示项。 -
dwFlags [in]
-
写入操作的用户界面和安全行为。
值 含义 - PST_NO_OVERWRITE
- 0x00000002
指定在受保护的存储中创建项。 不允许覆盖现有项。 - PST_UNRESTRICTED_ITEMDATA
- 0x00000004
指定数据流不安全。 默认情况下,项调用是安全的。
返回值
返回值为 HRESULT 值。 值为 PST_E_OK 表示函数成功。
要求
要求 | 值 |
---|---|
标头 |
|
DLL |
|
另请参阅