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 表示函数成功。

要求

要求
标头
Pstore.h
DLL
Pstorec.dll

另请参阅

IPStore

PST_PROMPTINFO