Metodo IXpsSignatureBlock::CreateRequest (xpsdigitalsignature.h)
Crea una nuova interfaccia IXpsSignatureRequest e la aggiunge al blocco di firma.
Sintassi
HRESULT CreateRequest(
[in] LPCWSTR requestId,
[out, retval] IXpsSignatureRequest **signatureRequest
);
Parametri
[in] requestId
Stringa che identifica in modo univoco la nuova richiesta di firma all'interno del blocco di firma. Per generare una stringa ID, impostare questo parametro su NULL.
[out, retval] signatureRequest
Puntatore alla nuova interfaccia IXpsSignatureRequest . Se non è necessario accedere alla nuova interfaccia di richiesta, questo parametro può essere impostato su NULL.
Valore restituito
Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a quelli della tabella che segue. Per i valori restituiti non elencati in questa tabella, vedere Errori dell'API firma digitale XPS e errori del documento XPS.
| Codice restituito | Descrizione |
|---|---|
|
Il metodo è riuscito. |
|
L'interfaccia non è connessa alla gestione delle firme o requestId è NULL e non è possibile generare una stringa ID univoca. |
Commenti
La nuova richiesta di firma deve avere un ID richiesta univoco; nessuna due richieste potrebbe avere la stessa stringa ID.
La creazione di una nuova richiesta contrassegna il blocco di firma come sporco e genera nuovo contenuto per la parte SignatureDefinitions. Quando il pacchetto XPS viene serializzato, il nuovo contenuto sovrascriverà il contenuto precedente nella parte SignatureDefinitions.
Requisiti
| Client minimo supportato | Windows 7 [solo app desktop] |
| Server minimo supportato | Windows Server 2008 R2 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | xpsdigitalsignature.h |