IOpcSignatureCustomObjectSet::Create メソッド (msopc.h)

[アーティクル]
03/05/2024

シグネチャ内のアプリケーション固有の Object 要素を表す IOpcSignatureCustomObject インターフェイスポインターを作成し、新しいインターフェイスをセットに追加します。

構文

HRESULT Create(
  [in]          const UINT8               *xmlMarkup,
  [in]          UINT32                    count,
  [out, retval] IOpcSignatureCustomObject **customObject
);

パラメーター

[in] xmlMarkup

表される Object 要素の XML マークアップを格納するバッファー。

この XML マークアップには、開く Object タグ と終了 /Object タグを含める必要があります。

xmlMarkup に含まれるマークアップのエンコードが推論されます。 xmlMarkup で渡されるバッファーの先頭にバイト順マークを含めることは省略可能です。

次のエンコーディングとバイトオーダーマーク値がサポートされています。

Encoding	説明	バイト順マーク (BOM: Byte Order Mark)
UTF8	UTF-8	EF BB BF
UTF16LE	UTF-16、リトルエンディアン	FF FE
UTF16BE	UTF-16、ビッグエンディアン	FE FF

[in] count

xmlMarkup バッファーのサイズ。

[out, retval] customObject

アプリケーション固有の Object 要素を表す新しい IOpcSignatureCustomObject インターフェイスポインター。

新しいインターフェイスへのポインターが必要ない場合、このパラメーターは NULL にすることができます。

戻り値

このメソッドは HRESULT を返します。有効な値を次の表に示しますが、これ以外にもあります。

リターンコード	説明
S_OK	メソッドが成功しました。
E_INVALIDARG	count パラメーターは 0 です。 xmlMarkup パラメーターには、有効な XML マークアップを渡す必要があります。
E_POINTER	xmlMarkup パラメーターは NULL です。

注釈

IOpcSignatureCustomObject インターフェイスポインターは、それが表す Object 要素の XML マークアップへのアクセスを提供します。 Object 要素の XML マークアップにアクセスするには、IOpcSignatureCustomObject::GetXml メソッドを呼び出します。

IOpcSignatureCustomObject インターフェイスポインターが作成され、セットに追加されると、それが表すオブジェクトはパッケージの保存時に保存されます。

スレッドセーフ

オブジェクトのパッケージ化はスレッドセーフではありません。

詳細については、「Packaging API を使用したはじめに」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	msopc.h