IPStore::WriteItem メソッド

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

パラメーター

キー [入力]

プロバイダーの記憶域。

値	説明
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