IXpsSignatureBlockCollection::RemoveAt メソッド (xpsdigitalsignature.h)
コレクション内の指定した場所から IXpsSignatureBlock インターフェイス ポインターを削除して解放します。
構文
HRESULT RemoveAt(
UINT32 index
);
パラメーター
index
IXpsSignatureBlock インターフェイス ポインターを削除して解放するコレクション内の 0 から始まるインデックス。
戻り値
メソッドが成功すると、S_OKが返されます。それ以外の場合は、 HRESULT エラー コードが返されます。
注釈
index で指定された場所から、このメソッドは IXpsSignatureBlock ポインターによって参照されるインターフェイスを解放します。 次に、 メソッドは、インデックスの後の各ポインターのインデックスを 1 ずつ減らすことでコレクションを圧縮 します。 コレクション メソッドの詳細については、「 XPS OM コレクション インターフェイスの操作」を参照してください。
コレクションから署名ブロックを削除すると、その署名ブロックに対応する SignatureDefinitions パーツとリレーションシップがパッケージから削除されます。 この削除により、既存の署名が中断されます。 さらに、SignatureDefinitions パーツ名は必要な XPS パーツの一覧から削除されるため、削除された署名ブロックを新しい署名に含めなくなります。
コレクションから削除されたインターフェイスは無効です。 アプリケーションがインターフェイスへのポインターを保持し、そのメソッドの 1 つを呼び出そうとすると、メソッドは XPS_E_OBJECT_DETACHEDを返します。
要件
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | xpsdigitalsignature.h |