estructura SIP_SUBJECTINFO (mssip.h)

  • Artículo

La estructura SIP_SUBJECTINFO especifica los datos de información del sujeto para las API del paquete de interfaz de asunto (SIP).

Sintaxis

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;

Miembros

cbSize

Tamaño, en bytes, de esta estructura.

pgSubjectType

Puntero a una estructura GUID que identifica el tipo de sujeto.

hFile

Identificador de archivo que representa el asunto. Si el tipo de almacenamiento del asunto es un archivo, establezca hFile en INVALID_HANDLE_VALUE y establezca el parámetro pwsFileName en el nombre del archivo.

pwsFileName

Puntero a una cadena Unicode terminada en null que contiene el nombre de archivo del asunto.

pwsDisplayName

Puntero a una cadena Unicode terminada en null que contiene el nombre para mostrar del asunto.

dwReserved1

Este miembro se reserva para uso futuro.

dwIntVersion

Este miembro está reservado. No modifique este miembro. El SIP lo usa para pasar el número de versión interno entre las funciones get y verify.

hProv

Un identificador HCRYPTPROV para el proveedor de criptografía.

DigestAlgorithm

Estructura CRYPT_ALGORITHM_IDENTIFIER que contiene el identificador del algoritmo hash utilizado para aplicar un algoritmo hash al archivo.

dwFlags

Valor que modifica el comportamiento de las funciones que usan esta estructura. Para obtener más información sobre los valores posibles para este miembro, vea el parámetro dwFlags de SignerSignEx.

dwEncodingType

Valor que especifica el tipo de codificación utilizado para el archivo. Actualmente, solo se usan X509_ASN_ENCODING y PKCS_7_ASN_ENCODING ; sin embargo, en el futuro se pueden agregar tipos de codificación adicionales. Para cualquier tipo de codificación actual, use: X509_ASN_ENCODING PKCS_7_ASN_ENCODING | .

dwReserved2

Este miembro se reserva para uso futuro.

fdwCAPISettings

Este miembro no se usa.

fdwSecuritySettings

Este miembro no se usa.

dwIndex

Índice de mensaje de la última llamada a CryptSIPGetSignedDataMsg. .

dwUnionChoice

Especifica el tipo de información adicional proporcionada.

Constante/valor definida Significado
MSSIP_ADDINFO_NONE
0
 No hay información adicional sobre el asunto.
MSSIP_ADDINFO_FLAT
1
 La información adicional es un archivo plano.
MSSIP_ADDINFO_CATMEMBER
2
 La información adicional es un miembro del catálogo.
MSSIP_ADDINFO_BLOB
3
 La información adicional es un BLOB.
MSSIP_ADDINFO_NONMSSIP
500
 La información adicional está en un formato definido por el usuario.

psFlat

Estructura MS_ADDINFO_FLAT que contiene información adicional para los tipos de asunto de archivo plano.

psCatMember

Estructura MS_ADDINFO_CATALOGMEMBER que contiene información adicional para los tipos de firmantes de miembro del catálogo.

psBlob

Estructura MS_ADDINFO_BLOB que contiene información adicional para los tipos de asunto BLOB.

psDetachedSig

pClientData

Puntero a datos específicos del SIP.

Comentarios

Tras el primer uso de la estructura SIP_SUBJECTINFO , inicialice toda la estructura en cero binario. No inicialice la estructura entre llamadas de función SIP.

Los temas incluyen, entre otros, imágenes ejecutables portables (.exe), imágenes de gabinete (.cab), archivos planos y archivos de catálogo. Cada tipo de asunto usa un subconjunto diferente de sus datos para el cálculo hash y requiere un procedimiento diferente para el almacenamiento y la recuperación. Por lo tanto, cada tipo de asunto tiene una especificación de paquete de interfaz de asunto única.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado mssip.h