IXpsSignatureBlock::CreateRequest-Methode (xpsdigitalsignature.h)
Erstellt eine neue IXpsSignatureRequest-Schnittstelle und fügt sie dem Signaturblock hinzu.
Syntax
HRESULT CreateRequest(
[in] LPCWSTR requestId,
[out, retval] IXpsSignatureRequest **signatureRequest
);
Parameter
[in] requestId
Eine Zeichenfolge, die die neue Signaturanforderung innerhalb des Signaturblocks eindeutig identifiziert. Legen Sie für die Methode zum Generieren einer ID-Zeichenfolge diesen Parameter auf NULL fest.
[out, retval] signatureRequest
Ein Zeiger auf die neue IXpsSignatureRequest-Schnittstelle . Wenn kein Zugriff auf die neue Anforderungsschnittstelle erforderlich ist, kann dieser Parameter auf NULL festgelegt werden.
Rückgabewert
Die Methode gibt ein HRESULT zurück. Mögliche Werte sind unter anderem diejenigen in der folgenden Tabelle. Rückgabewerte, die in dieser Tabelle nicht aufgeführt sind, finden Sie unter XPS Digital Signature-API-Fehler und XPS-Dokumentfehler.
| Rückgabecode | Beschreibung |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Entweder ist die Schnittstelle nicht mit dem Signatur-Manager verbunden, oder requestId ist NULL , und eine eindeutige ID-Zeichenfolge konnte nicht generiert werden. |
Hinweise
Die neue Signaturanforderung muss über eine eindeutige Anforderungs-ID verfügen. keine zwei Anforderungen dürfen dieselbe ID-Zeichenfolge aufweisen.
Beim Erstellen einer neuen Anforderung wird der Signaturblock als modifiziert markiert und neuer Inhalt für den SignatureDefinitions-Teil generiert. Wenn das XPS-Paket serialisiert wird, überschreibt der neue Inhalt den vorherigen Inhalt im SignatureDefinitions-Teil.
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 |