Метод IXpsSignatureBlockCollection::RemoveAt (xpsdigitalsignature.h)
Удаляет и освобождает указатель интерфейса IXpsSignatureBlock из указанного расположения в коллекции.
Синтаксис
HRESULT RemoveAt(
UINT32 index
);
Параметры
index
Отсчитываемый от нуля индекс в коллекции, из которого должен быть удален и освобожден указатель интерфейса IXpsSignatureBlock .
Возвращаемое значение
Если метод завершается успешно, он возвращает S_OK; в противном случае возвращается код ошибки HRESULT .
Комментарии
Из расположения, указанного индексом, этот метод освобождает интерфейс, на который ссылается указатель IXpsSignatureBlock . Затем метод сжимает коллекцию, уменьшая на 1 индекс каждого указателя после индекса. Дополнительные сведения о методах сбора см. в статье Работа с интерфейсами коллекции XPS OM.
При удалении блока подписи из коллекции из пакета удаляются часть SignatureDefinitions и связь, соответствующие блоку сигнатуры. Это удаление нарушает существующие сигнатуры. Кроме того, имя части SignatureDefinitions удаляется из списка обязательных частей XPS, что не позволяет новым подписям включать удаленный блок подписи.
Интерфейс, который был удален из коллекции, больше не является допустимым. Если приложение сохраняет указатель на интерфейс и пытается вызвать один из своих методов, метод вернет XPS_E_OBJECT_DETACHED.
Требования
Минимальная версия клиента | Windows 7 [только классические приложения] |
Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
Целевая платформа | Windows |
Header | xpsdigitalsignature.h |