IXpsSignatureBlockCollection::RemoveAt-Methode (xpsdigitalsignature.h)
Entfernt einen IXpsSignatureBlock-Schnittstellenzeiger von einem angegebenen Speicherort in der Auflistung und gibt diesen frei.
Syntax
HRESULT RemoveAt(
UINT32 index
);
Parameter
index
Der nullbasierte Index in der Auflistung, aus dem ein IXpsSignatureBlock-Schnittstellenzeiger entfernt und freigegeben werden soll.
Rückgabewert
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.
Hinweise
Von der durch index angegebenen Position gibt diese Methode die Schnittstelle frei, auf die mit einem IXpsSignatureBlock-Zeiger verwiesen wird. Die -Methode komprimiert dann die Auflistung, indem der Index jedes Zeigers, der auf den Index folgt, um 1 reduziert wird. Weitere Informationen zu den Auflistungsmethoden finden Sie unter Arbeiten mit XPS OM-Sammlungsschnittstellen.
Wenn Sie einen Signaturblock aus der Auflistung entfernen, werden der SignatureDefinitions-Teil und die Beziehung, die diesem Signaturblock entsprechen, aus dem Paket entfernt. Durch diese Entfernung werden vorhandene Signaturen unterbrochen. Darüber hinaus wird der Name des SignatureDefinitions-Teils aus der Liste der erforderlichen XPS-Teile entfernt, wodurch verhindert wird, dass neue Signaturen den entfernten Signaturblock einschließen.
Eine Schnittstelle, die aus einer Auflistung entfernt wurde, ist nicht mehr gültig. Wenn eine Anwendung einen Zeiger auf die Schnittstelle beibehält und versucht, eine ihrer Methoden aufzurufen, gibt die Methode XPS_E_OBJECT_DETACHED zurück.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | xpsdigitalsignature.h |