CryptSIPPutSignedDataMsg-Funktion (mssip.h)

  • Artikel

Die CryptSIPPutSignedDataMsg-Funktion speichert eine Authenticode-Signatur in der Zieldatei.

Syntax

BOOL CryptSIPPutSignedDataMsg(
  [in]  SIP_SUBJECTINFO *pSubjectInfo,
  [in]  DWORD           dwEncodingType,
  [out] DWORD           *pdwIndex,
  [in]  DWORD           cbSignedDataMsg,
  [in]  BYTE            *pbSignedDataMsg
);

Parameter

[in] pSubjectInfo

Zeiger auf eine SIP_SUBJECTINFO Struktur, die Informationen zum Betreff der Nachricht enthält.

[in] dwEncodingType

Der Codierungstyp der Nachricht. Dies kann eine Kombination aus einem oder mehreren der folgenden Werte sein.

Wert Bedeutung
PKCS_7_ASN_ENCODING
65536 (0x10000)
 Gibt die PKCS #7-Nachrichtencodierung an.
X509_ASN_ENCODING
1 (0x1)
 Gibt die X.509-Zertifikatcodierung an.

[out] pdwIndex

Zeiger auf den Nachrichtenindex.

[in] cbSignedDataMsg

Länge des Puffers in Bytes, auf den der Parameter pbSignedDataMsg verweist.

[in] pbSignedDataMsg

Zeiger auf den Puffer, der die Nachricht enthält.

Rückgabewert

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

Wenn die Funktion fehlschlägt, wird FALSE zurückgegeben. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten. Es folgen einige mögliche Fehlercodes.

Rückgabecode Beschreibung
ERROR_BAD_FORMAT
 Das angegebene Daten- oder Dateiformat des Antragstellerschnittstellenpakets (Subject Interface Package , SIP) ist ungültig.
ERROR_INVALID_PARAMETER
 Dieser Code kann aus den folgenden Gründen zurückgegeben werden:
  • pSubjectInfo ist NULL.
  • PdwIndex ist NULL.
  • PbSignedDataMsg ist NULL.
  • Der Wert des cbSignedDataMsg-Parameters ist kleiner als eins.
    • [SIP_SUBJECTINFO] (/windows/desktop/api/mssip/ns-mssip-sip_subjectinfo)-Struktur. [SIP_SUBJECTINFO] (/windows/desktop/api/mssip/ns-mssip-sip_subjectinfo)-Struktur.
TRUST_E_SUBJECT_FORM_UNKNOWN
 Der angegebene Antragstellertyp ist ungültig.

Hinweise

Jeder Antragstellertyp verwendet eine andere Teilmenge seiner Daten für die Hashberechnung und erfordert eine andere Prozedur zum Speichern und Abrufen. Daher verfügt jeder Antragstellertyp über eine eindeutige SIP-Spezifikation.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mssip.h
Bibliothek Crypt32.lib
DLL Crypt32.dll

Weitere Informationen

CryptSIPGetSignedDataMsg

CryptSIPRemoveSignedDataMsg