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 的指標，識別要讀取之專案的資料類型。
-
pItemSubtype [in]
-
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 |
|
另請參閱