SignerTimeStampEx2-Funktion

  • Artikel

Die SignerTimeStampEx2-Funktion zeitstempelt den angegebenen Betreff und gibt optional einen Zeiger auf eine SIGNER_CONTEXT Struktur zurück, die einen Zeiger auf ein BLOB enthält. Diese Funktion kann verwendet werden, um X.509 Public Key Infrastructure, RFC 3161-konform, Zeitstempel auszuführen.

Hinweis

Diese Funktion verfügt über keine zugeordnete Headerdatei oder Importbibliothek. Um diese Funktion aufzurufen, müssen Sie eine benutzerdefinierte Headerdatei erstellen und die Funktionen LoadLibrary und GetProcAddress zum dynamischen Verknüpfen mit Mssign32.dll verwenden.

 

Syntax

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 
);

Parameter

dwFlags [in]

Wert, der den Typ des zu generierenden Zeitstempels angibt. Dieser Parameter kann einen der folgenden Werte annehmen. Die Werte schließen sich gegenseitig aus.

Wert Bedeutung
SIGNER_TIMESTAMP_AUTHENTICODE
 Gibt einen Authenticode-Zeitstempel an.
SIGNER_TIMESTAMP_RFC3161
 Gibt einen RFC 3161-konformen Zeitstempel an.

 

pSubjectInfo [in]

Die Adresse einer SIGNER_SUBJECT_INFO-Struktur , die das Subjekt darstellt, das zeitstempelt werden soll.

pwszHttpTimeStamp [in]

Die Adresse einer Unicode-Zeichenfolge mit Null-Beendigung, die die URL eines Zeitstempelservers enthält.

dwAlgId [in]

Gibt einen Hashalgorithmus an, der zum Ausführen von RFC 3161-konformen Zeitstempeln verwendet werden soll. Dieser Parameter wird für Authenticode-Zeitstempel ignoriert.

psRequest [in]

Optional. Die Adresse einer CRYPT_ATTRIBUTES-Struktur , die zusätzliche Attribute enthält, die der Zeitstempelanforderung hinzugefügt werden.

Dieser Parameter ist optional und kann NULL sein, wenn er nicht enthalten ist.

pSipData [in]

Optional. Ein 32-Bit-Wert, der als zusätzliche Daten an SIP-Funktionen ( Subject Interface Package ) übergeben wird. Format und Inhalt dieses Parameters werden vom SIP-Anbieter definiert.

Dieser Parameter ist optional und kann NULL sein, wenn er nicht enthalten ist.

ppSignerContext [out]

Optional. Die Adresse eines Zeigers auf die SIGNER_CONTEXT Struktur, die das signierte BLOB enthält. Wenn Sie die verwendung der SIGNER_CONTEXT-Struktur abgeschlossen haben, geben Sie sie frei, indem Sie die Funktion SignerFreeSignerContext aufrufen.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion S_OK zurück.

Wenn die Funktion fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Windows Server 2008 R2 [nur Desktop-Apps]
DLL
Mssign32.dll

Weitere Informationen

SignerTimeStamp

SignerTimeStampEx