Интерфейс IXpsSignatureManager (xpsdigitalsignature.h)
Управляет цифровыми подписями и запросами цифровой подписи документа XPS.
Наследование
Интерфейс IXpsSignatureManager наследуется от интерфейса IUnknown . IXpsSignatureManager также имеет следующие типы элементов:
Методы
Интерфейс IXpsSignatureManager содержит следующие методы.
| IXpsSignatureManager::AddSignatureBlock Создает интерфейс IXpsSignatureBlock и добавляет его в коллекцию блоков подписи. |
| IXpsSignatureManager::CreateSigningOptions Создает интерфейс IXpsSigningOptions. |
| IXpsSignatureManager::GetSignatureBlocks Возвращает указатель на интерфейс IXpsSignatureBlockCollection, содержащий коллекцию блоков подписи. |
| IXpsSignatureManager::GetSignatureOriginPartName Возвращает имя части исходной части сигнатуры. |
| IXpsSignatureManager::GetSignatures Возвращает указатель на интерфейс IXpsSignatureCollection, содержащий коллекцию цифровых подписей XPS. |
| IXpsSignatureManager::LoadPackageFile Загружает существующий пакет XPS из файла в диспетчер цифровых подписей. |
| IXpsSignatureManager::LoadPackageStream Загружает пакет XPS из потока в диспетчер цифровых подписей. |
| IXpsSignatureManager::SavePackageToFile Сохраняет пакет XPS в файл. |
| IXpsSignatureManager::SavePackageToStream Сохраняет пакет XPS, записывая его в поток. |
| IXpsSignatureManager::SetSignatureOriginPartName Задает имя части исходной части сигнатуры. |
| IXpsSignatureManager::Sign Подписывает содержимое пакета XPS в соответствии с параметрами подписывания и возвращает полученную цифровую подпись. |
Комментарии
Чтобы инициализировать диспетчер подписей для использования с документом XPS, создайте экземпляр интерфейса IXpsSignatureManager , вызвав CoCreateInstance , как показано в следующем примере.
IXpsSignatureManager *newInterface;
// Note the implicit requirement that CoInitializeEx
// has previously been called from this thread.
hr = CoCreateInstance(
__uuidof(XpsSignatureManager),
NULL,
CLSCTX_INPROC_SERVER,
__uuidof(IXpsSignatureManager),
reinterpret_cast<LPVOID*>(&newInterface));
// make sure that you got a pointer
// to the interface
if (SUCCEEDED(hr)) {
// Load document into signature manager from file.
// xpsDocument is initialized with the file name
// of the document to load outside of this example.
hr = newInterface->LoadPackageFile (xpsDocument);
// Use newInterface
// Release interface pointers when finished with them
newInterface->Release();
}
Интерфейс, созданный CoCreateInstance , может использоваться только одним документом XPS, который необходимо загрузить путем вызова LoadPackageFile или LoadPackageStream перед вызовом любого другого метода.
После создания экземпляра интерфейса IXpsSignatureManager и загрузки документа XPS диспетчер подписей готов к использованию.
Требования
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
| Целевая платформа | Windows |
| Header | xpsdigitalsignature.h |