Funzione SignerTimeStampEx2

Il timestamp della funzione SignerTimeStampEx2 viene contrassegnato dall'oggetto specificato e, facoltativamente, restituisce un puntatore a una struttura SIGNER_CONTEXT contenente un puntatore a un BLOB. Questa funzione può essere usata per eseguire l'infrastruttura a chiave pubblica X.509, RFC 3161 conforme ai timestamp.

Nota

Questa funzione non ha alcun file di intestazione associato o una libreria di importazione. Per chiamare questa funzione, è necessario creare un file di intestazione definito dall'utente e usare le funzioni LoadLibrary e GetProcAddress per collegare dinamicamente a Mssign32.dll.

 

Sintassi

HRESULT WINAPI SignerTimeStampEx2(
  _Reserved_ DWORD               dwFlags,
  _In_       SIGNER_SUBJECT_INFO *pSubjectInfo,
  _In_       LPCWSTR             pwszHttpTimeStamp,
  _In_       ALG_ID              dwAlgId,
  _In_       PCRYPT_ATTRIBUTES   psRequest,
  _In_       LPVOID              pSipData,
  _Out_      SIGNER_CONTEXT      **ppSignerContext 
);

Parametri

dwFlags [in]

Valore che specifica il tipo di timestamp da generare. Questo parametro può avere uno dei valori seguenti. I valori sono reciprocamente esclusivi.

Valore Significato
SIGNER_TIMESTAMP_AUTHENTICODE
Specifica un timestamp Authenticode.
SIGNER_TIMESTAMP_RFC3161
Specifica un timestamp conforme a RFC 3161.

 

pSubjectInfo [in]

Indirizzo di una struttura SIGNER_SUBJECT_INFO che rappresenta l'oggetto da specificare.

pwszHttpTimeStamp [in]

Indirizzo di una stringa Unicode con terminazione null contenente l'URL di un server timestamp.

dwAlgId [in]

Specifica un algoritmo hash da usare per l'esecuzione di timestamp conformi a RFC 3161. Questo parametro viene ignorato per i timestamp Authenticode.

psRequest [in]

Facoltativa. Indirizzo di una struttura CRYPT_ATTRIBUTES che contiene attributi aggiuntivi aggiunti alla richiesta di timestamp.

Questo parametro è facoltativo e può essere NULL se non è incluso.

pSipData [in]

Facoltativa. Valore a 32 bit passato come dati aggiuntivi alle funzioni SIP ( Subject Interface Package ). Il formato e il contenuto di questo parametro sono definiti dal provider SIP.

Questo parametro è facoltativo e può essere NULL se non è incluso.

ppSignerContext [out]

Facoltativa. Indirizzo di un puntatore alla struttura SIGNER_CONTEXT contenente il BLOB firmato. Al termine dell'uso della struttura SIGNER_CONTEXT , liberarla chiamando la funzione SignerFreeSignerContext .

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce S_OK.

Se la funzione ha esito negativo, restituisce un valore HRESULT che indica l'errore. Per un elenco di codici di errore comuni, vedere Valori HRESULT comuni.

Requisiti

Requisito Valore
Client minimo supportato
Windows 7 [solo app desktop]
Server minimo supportato
Windows Server 2008 R2 [solo app desktop]
DLL
Mssign32.dll

Vedi anche

SignerTimeStamp

SignerTimeStampEx