IPStore::ReadItem メソッド

[Protected Storage (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
);

パラメーター

キー [入力]

プロバイダーの記憶域。

値	説明
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 関数を使用して、返されたデータ バッファーを解放します。

要件

要件	値
ヘッダー	Pstore.h
[DLL]	Pstorec.dll

関連項目

IPStore

PST_PROMPTINFO