Funzione CryptSIPPutSignedDataMsg (mssip.h)

Articolo
02/29/2024

La funzione CryptSIPPutSignedDataMsg archivia una firma Authenticode nel file di destinazione.

Sintassi

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

Parametri

[in] pSubjectInfo

Puntatore a una struttura SIP_SUBJECTINFO che contiene informazioni sull'oggetto del messaggio.

[in] dwEncodingType

Tipo di codifica del messaggio. Può trattarsi di una combinazione di uno o più dei valori seguenti.

Valore	Significato
PKCS_7_ASN_ENCODING 65536 (0x10000)	Specifica la codifica dei messaggi PKCS #7 .
X509_ASN_ENCODING 1 (0x1)	Specifica la codifica del certificato X.509 .

[out] pdwIndex

Puntatore all'indice del messaggio.

[in] cbSignedDataMsg

Lunghezza, in byte, del buffer a cui punta il parametro pbSignedDataMsg .

[in] pbSignedDataMsg

Puntatore al buffer contenente il messaggio.

Valore restituito

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

Se la funzione ha esito negativo, restituisce FALSE. Per informazioni sugli errori estesi, chiamare GetLastError. Di seguito sono riportati alcuni possibili codici di errore.

Codice restituito	Descrizione
ERROR_BAD_FORMAT	Il formato di dati o file specificato del pacchetto SIP ( Subject Interface Package ) non è valido.
ERROR_INVALID_PARAMETER	Questo codice può essere restituito per i motivi seguenti: pSubjectInfo è NULL. PdwIndex è NULL. PbSignedDataMsg è NULL. Il valore del parametro cbSignedDataMsg è minore di uno. [SIP_SUBJECTINFO] Struttura (/windows/desktop/api/mssip/ns-mssip-sip_subjectinfo). [SIP_SUBJECTINFO] Struttura (/windows/desktop/api/mssip/ns-mssip-sip_subjectinfo).
TRUST_E_SUBJECT_FORM_UNKNOWN	Il tipo di soggetto specificato non è valido.

Commenti

Ogni tipo di soggetto usa un subset diverso dei relativi dati per il calcolo hash e richiede una procedura diversa per l'archiviazione e il recupero. Pertanto, ogni tipo di soggetto ha una specifica SIP univoca.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mssip.h
Libreria	Crypt32.lib
DLL	Crypt32.dll

Vedi anche

CryptSIPGetSignedDataMsg

CryptSIPRemoveSignedDataMsg

Condividi tramite