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表示函式成功。
規格需求
需求 | 值 |
---|---|
標頭 |
|
DLL |
|
另請參閱