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
);

參數

機碼 [in]

提供者儲存區域。

值	意義
PST_KEY_CURRENT_USER 0x00000000	儲存體會保留在登錄的目前使用者區段中。
PST_KEY_LOCAL_MACHINE 0x00000001	儲存體會保留在登錄的本機電腦區段中。

 

pItemType [in]

GUID的指標，識別正在寫入之資料項目的資料類型。

pItemSubtype [in]

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