SIP_SUBJECTINFO struttura (mssip.h)

  • Articolo

La struttura SIP_SUBJECTINFO specifica i dati degli interessati alle API SIP ( Subject Interface Package ).

Sintassi

typedef struct SIP_SUBJECTINFO_ {
  DWORD                      cbSize;
  GUID                       *pgSubjectType;
  HANDLE                     hFile;
  LPCWSTR                    pwsFileName;
  LPCWSTR                    pwsDisplayName;
  DWORD                      dwReserved1;
  DWORD                      dwIntVersion;
  HCRYPTPROV                 hProv;
  CRYPT_ALGORITHM_IDENTIFIER DigestAlgorithm;
  DWORD                      dwFlags;
  DWORD                      dwEncodingType;
  DWORD                      dwReserved2;
  DWORD                      fdwCAPISettings;
  DWORD                      fdwSecuritySettings;
  DWORD                      dwIndex;
  DWORD                      dwUnionChoice;
  union {
#if ...
    MS_ADDINFO_FLAT_                 *psFlat;
#else
    struct MS_ADDINFO_FLAT_          *psFlat;
#endif
#if ...
    MS_ADDINFO_CATALOGMEMBER_        *psCatMember;
#else
    struct MS_ADDINFO_CATALOGMEMBER_ *psCatMember;
#endif
#if ...
    MS_ADDINFO_BLOB_                 *psBlob;
#else
    struct MS_ADDINFO_BLOB_          *psBlob;
#endif
#if ...
    MS_ADDINFO_DETACHEDSIG_          *psDetachedSig;
#else
    struct MS_ADDINFO_DETACHEDSIG_   *psDetachedSig;
#endif
  };
  LPVOID                     pClientData;
} SIP_SUBJECTINFO, *LPSIP_SUBJECTINFO;

Members

cbSize

Dimensione, in byte, della struttura.

pgSubjectType

Puntatore a una struttura GUID che identifica il tipo di oggetto.

hFile

Handle di file che rappresenta l'oggetto. Se il tipo di archiviazione dell'oggetto è un file, impostare hFile su INVALID_HANDLE_VALUE e impostare il parametro pwsFileName sul nome del file.

pwsFileName

Puntatore a una stringa Unicode con terminazione null contenente il nome file del soggetto.

pwsDisplayName

Puntatore a una stringa Unicode con terminazione null contenente il nome visualizzato dell'oggetto.

dwReserved1

Questo membro è riservato per usi futuri.

dwIntVersion

Questo membro è riservato. Non modificare questo membro. Viene usato da SIP per passare il numero di versione interno tra le funzioni get e verifica.

hProv

Handle HCRYPTPROV per il provider di crittografia.

DigestAlgorithm

Struttura CRYPT_ALGORITHM_IDENTIFIER che contiene l'identificatore per l'algoritmo hash usato per l'hash del file.

dwFlags

Valore che modifica il comportamento delle funzioni che usano questa struttura. Per altre informazioni sui valori possibili per questo membro, vedere il parametro dwFlags di SignerSignEx.

dwEncodingType

Valore che specifica il tipo di codifica usato per il file. Attualmente vengono usati solo X509_ASN_ENCODING e PKCS_7_ASN_ENCODING ; Tuttavia, è possibile aggiungere altri tipi di codifica in futuro. Per entrambi i tipi di codifica correnti, usare: X509_ASN_ENCODING PKCS_7_ASN_ENCODING | .

dwReserved2

Questo membro è riservato per usi futuri.

fdwCAPISettings

Questo membro non viene usato.

fdwSecuritySettings

Questo membro non viene usato.

dwIndex

Indice del messaggio dell'ultima chiamata a CryptSIPGetSignedDataMsg. .

dwUnionChoice

Specifica il tipo di informazioni aggiuntive fornite.

Costante/valore definiti Significato
MSSIP_ADDINFO_NONE
0
 Non sono disponibili informazioni aggiuntive sull'oggetto.
MSSIP_ADDINFO_FLAT
1
 Le informazioni aggiuntive sono un file flat.
MSSIP_ADDINFO_CATMEMBER
2
 Le informazioni aggiuntive sono un membro del catalogo.
MSSIP_ADDINFO_BLOB
3
 Le informazioni aggiuntive sono un BLOB.
MSSIP_ADDINFO_NONMSSIP
500
 Le informazioni aggiuntive sono in formato definito dall'utente.

psFlat

Struttura MS_ADDINFO_FLAT contenente informazioni aggiuntive per i tipi di oggetto file flat.

psCatMember

Struttura MS_ADDINFO_CATALOGMEMBER contenente informazioni aggiuntive per i tipi di oggetto del catalogo.

psBlob

Struttura MS_ADDINFO_BLOB contenente informazioni aggiuntive per i tipi di oggetto BLOB.

psDetachedSig

pClientData

Puntatore ai dati specifici di SIP.

Commenti

Al primo uso della struttura SIP_SUBJECTINFO , inizializzare l'intera struttura su zero binario. Non inizializzare la struttura tra chiamate di funzione SIP.

I soggetti includono, ma non sono limitati a, immagini eseguibili portabili (.exe), immagini di gabinetto (.cab), file flat e file di catalogo. Ogni tipo di oggetto usa un sottoinsieme 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 univoca del pacchetto dell'interfaccia soggetto.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Intestazione mssip.h