Freigeben über

Hinzufügen einer Signaturanforderung zu einem XPS-Dokument

  • Artikel

In diesem Thema wird beschrieben, wie Sie einem XPS-Dokument eine Signaturanforderung hinzufügen. Eine Signaturanforderung fordert Benutzer*innen auf, ein Dokument zu signieren, wenn sie der Signaturabsicht zustimmen.

Bevor Sie die folgenden Codebeispiele in Ihrem Programm verwenden, lesen Sie den Haftungsausschluss in Allgemeine Aufgaben bei der Programmierung digitaler Signaturen.

Hinzufügen einer Signaturanforderung zu einem XPS-Dokument:

  1. Laden Sie das XPS-Dokument in einen Signatur-Manager, wie in Signatur-Manager initialisieren beschrieben.
  2. Fügen Sie dem Signatur-Manager einen Signaturblock hinzu.
  3. Erstellen Sie eine Signaturanforderung im neuen Signaturblock.
  4. Legen Sie die Eigenschaften der Signaturanforderung fest:
    1. Legen Sie die Signaturabsicht fest.
    2. Legen Sie den Namen der Person fest, deren Signatur angefordert wird (der angeforderte Signaturgeber).
    3. Legen Sie das Datum fest, an dem die Signatur erforderlich ist.
    4. Legen Sie bei Bedarf andere Signatureigenschaften fest.

Das folgende Codebeispiel veranschaulicht das Hinzufügen einer Signaturanforderung zu einem XPS-Dokument.

HRESULT 
AddSignatureRequestToDocument (
    __in IXpsSignatureManager    *signatureManager,
    __in LPCWSTR                reasonForSignatureRequest,
    __in LPCWSTR                nameOfRequestedSigner,
    __in LPCWSTR                requestSignByDate
)
{
    HRESULT                  hr = S_OK;
    IXpsSignatureBlock       *signatureDefinition = NULL;
    IXpsSignatureRequest     *signatureRequest = NULL;
    
    // Create a new signature block and get a pointer to it
    hr = signatureManager->AddSignatureBlock (NULL, 0, &signatureDefinition);
    
    if (SUCCEEDED(hr)) {
        // Create a new signature request to use for this signature block
        hr = signatureDefinition->CreateRequest(NULL, &signatureRequest);
    }

    if (SUCCEEDED(hr)) {
        // Initialize the properties of the signature request

        //  Set the string that describes the purpose of the signature
        //  to the person who will sign the document.
        hr = signatureRequest->SetIntent(reasonForSignatureRequest);
    }

    if (SUCCEEDED(hr)) {
        //  Set the name of the person whose signature is requested.
        hr = signatureRequest->SetRequestedSigner(nameOfRequestedSigner);
    }

    if (SUCCEEDED(hr)) {
        //  Set the date that the person should sign the document.
        //  The person is requested to sign the document on or before
        //   the date specified in this field. Refer to the help text
        //   for the correct format of this string.
        hr = signatureRequest->SetRequestSignByDate(requestSignByDate);
    }

    if (NULL != signatureDefinition) signatureDefinition->Release();
    if (NULL != signatureRequest) signatureRequest->Release();

    return hr;
}

In diesem Abschnitt verwendet

IXpsSignatureBlock

IXpsSignatureBlock::CreateRequest

IXpsSignatureManager

IXpsSignatureManager::AddSignatureBlock

IXpsSignatureRequest

IXpsSignatureRequest::SetIntent

IXpsSignatureRequest::SetRequestedSigner

IXpsSignatureRequest::SetRequestSignByDate

Weitere Informationen

API-Fehler bei der digitalen XPS-Signatur

XPS-Dokumentfehler

XML Paper Specification