IPersistSerializedPropStorage2::GetPropertyStorageBuffer メソッド (propsys.h)

シリアル化されたプロパティ ストレージ バッファーをプロパティ ストア インスタンスから取得します。

構文

HRESULT GetPropertyStorageBuffer(
  [out] SERIALIZEDPROPSTORAGE *psps,
  [in]  DWORD                 cb,
  [out] DWORD                 *pcbWritten
);

パラメーター

[out] psps

型: SERIALIZEDPROPSTORAGE*

このメソッドが正常に返されると、プロパティ ストレージ バッファーの内容が格納されます。

[in] cb

型: DWORD

psps が指すバッファーの初期サイズ (バイト単位)

[out] pcbWritten

種類: DWORD*

psps が指すシリアル化されたプロパティ ストレージ バッファーに含まれるバイト数。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

cb がシリアル化されたデータの合計サイズより小さい場合、このメソッドはエラーを返します。

SERIALIZEDPROPSTORAGE 型は、Propsys.h で不完全な型として定義されています。 BYTE 値の配列として扱う必要があります。返されるデータの形式が指定されていません。 SERIALIZEDPROPSTORAGE 構造体の内容は、ディスクまたはその他のストレージへの永続化に適しており、IPersistSerializedPropStorage::SetPropertyStorage を使用して別のプロパティ ストアを初期化するために使用できます。

要件