IXpsSignatureManager-Schnittstelle (xpsdigitalsignature.h)
Verwaltet die digitalen Signaturen und digitalen Signaturanforderungen eines XPS-Dokuments.
Vererbung
Die IXpsSignatureManager-Schnittstelle erbt von der IUnknown-Schnittstelle . IXpsSignatureManager verfügt auch über die folgenden Typen von Membern:
Methoden
Die IXpsSignatureManager-Schnittstelle verfügt über diese Methoden.
| IXpsSignatureManager::AddSignatureBlock Erstellt eine neue IXpsSignatureBlock-Schnittstelle und fügt sie der Signaturblockauflistung hinzu. |
| IXpsSignatureManager::CreateSigningOptions Erstellt eine neue IXpsSigningOptions-Schnittstelle. |
| IXpsSignatureManager::GetSignatureBlocks Ruft einen Zeiger auf eine IXpsSignatureBlockCollection-Schnittstelle ab, die eine Auflistung von Signaturblöcken enthält. |
| IXpsSignatureManager::GetSignatureOriginPartName Ruft den Teilenamen des Signaturursprungteils ab. |
| IXpsSignatureManager::GetSignatures Ruft einen Zeiger auf eine IXpsSignatureCollection-Schnittstelle ab, die eine Sammlung digitaler XPS-Signaturen enthält. |
| IXpsSignatureManager::LoadPackageFile Lädt ein vorhandenes XPS-Paket aus einer Datei in den Digitalen Signatur-Manager. |
| IXpsSignatureManager::LoadPackageStream Lädt ein XPS-Paket aus einem Stream in den Digitalen Signatur-Manager. |
| IXpsSignatureManager::SavePackageToFile Speichert das XPS-Paket in einer Datei. |
| IXpsSignatureManager::SavePackageToStream Speichert das XPS-Paket, indem es in einen Stream geschrieben wird. |
| IXpsSignatureManager::SetSignatureOriginPartName Legt den Teilenamen des Signaturursprungteils fest. |
| IXpsSignatureManager::Sign Signiert den Inhalt eines XPS-Pakets gemäß den Signaturoptionen und gibt die resultierende digitale Signatur zurück. |
Hinweise
Um den Signatur-Manager für die Verwendung mit einem XPS-Dokument zu initialisieren, instanziieren Sie eine IXpsSignatureManager-Schnittstelle , indem Sie CoCreateInstance aufrufen, wie im folgenden Beispiel gezeigt.
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();
}
Die von CoCreateInstance instanziierte Schnittstelle kann nur von einem XPS-Dokument verwendet werden, das durch Aufrufen von LoadPackageFile oder LoadPackageStream geladen werden muss, bevor eine andere Methode aufgerufen wird.
Nachdem die IXpsSignatureManager-Schnittstelle instanziiert und ein XPS-Dokument geladen wurde, ist der Signatur-Manager einsatzbereit.
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 |