Metodo IXpsSignatureRequest::GetRequestId (xpsdigitalsignature.h)
Ottiene l'identificatore univoco della richiesta di firma.
Sintassi
HRESULT GetRequestId(
[out, retval] LPWSTR *requestId
);
Parametri
[out, retval] requestId
Identificatore univoco della richiesta di firma.
Valore restituito
Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non solo, quelli nella 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. |
|
requestId è NULL. |
|
L'interfaccia non è connessa al gestore delle firme. |
Commenti
Questo metodo alloca la memoria usata dalla stringa restituita in requestId. Se requestId non è NULL, usare la funzione CoTaskMemFree per liberare la memoria.
Il parametro requestId riceve il valore dell'attributo SpotID dell'elemento SignatureDefinition . L'attributo SpotID è obbligatorio e deve seguire il formato xs:ID (ID XML); Tuttavia, le parti SignatureDefinitions esistenti non vengono controllate per la conformità al formato consigliato. Alcuni documenti XPS prodotti da applicazioni Windows Presentation Foundation (WPF) possono avere un ID che inizia con una cifra.
Requisiti
| Requisito | Valore |
|---|---|
| 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 |