Funzione CryptSIPPutSignedDataMsg (mssip.h)

  • Articolo

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