estrutura SIP_SUBJECTINFO (mssip.h)

A estrutura SIP_SUBJECTINFO especifica os dados de informações do assunto para as APIs sip ( pacote de interface de entidade ).

Sintaxe

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;

Membros

cbSize

O tamanho, em bytes, dessa estrutura.

pgSubjectType

Um ponteiro para uma estrutura GUID que identifica o tipo de assunto.

hFile

Um identificador de arquivo que representa o assunto. Se o tipo de armazenamento da entidade for um arquivo, defina hFile como INVALID_HANDLE_VALUE e defina o parâmetro pwsFileName como o nome do arquivo.

pwsFileName

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o nome do arquivo da entidade.

pwsDisplayName

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o nome de exibição do assunto.

dwReserved1

Este membro é reservado para uso futuro.

dwIntVersion

Este membro está reservado. Não modifique esse membro. Ele é usado pelo SIP para passar o número de versão interno entre as funções get e verify.

hProv

Um identificador HCRYPTPROV para o provedor de criptografia.

DigestAlgorithm

Uma estrutura CRYPT_ALGORITHM_IDENTIFIER que contém o identificador do algoritmo de hash usado para hash do arquivo.

dwFlags

Um valor que modifica o comportamento das funções que usam essa estrutura. Para obter mais informações sobre valores possíveis para esse membro, consulte o parâmetro dwFlags de SignerSignEx.

dwEncodingType

Um valor que especifica o tipo de codificação usado para o arquivo. Atualmente, apenas X509_ASN_ENCODING e PKCS_7_ASN_ENCODING estão sendo usados; no entanto, tipos de codificação adicionais podem ser adicionados no futuro. Para qualquer tipo de codificação atual, use: X509_ASN_ENCODING | PKCS_7_ASN_ENCODING.

dwReserved2

Este membro é reservado para uso futuro.

fdwCAPISettings

Este membro não é usado.

fdwSecuritySettings

Este membro não é usado.

dwIndex

O índice de mensagem da última chamada para CryptSIPGetSignedDataMsg. operação.

dwUnionChoice

Especifica o tipo de informações adicionais fornecidas.

Constante/valor definido	Significado
MSSIP_ADDINFO_NONE 0	Não há informações adicionais sobre o assunto.
MSSIP_ADDINFO_FLAT 1	As informações adicionais são um arquivo simples.
MSSIP_ADDINFO_CATMEMBER 2	As informações adicionais são um membro do catálogo.
MSSIP_ADDINFO_BLOB 3	As informações adicionais são um BLOB.
MSSIP_ADDINFO_NONMSSIP 500	As informações adicionais estão em um formato definido pelo usuário.

psFlat

Uma estrutura MS_ADDINFO_FLAT que contém informações adicionais para tipos de assunto de arquivo simples.

psCatMember

Uma estrutura MS_ADDINFO_CATALOGMEMBER que contém informações adicionais para tipos de assunto de membro do catálogo.

psBlob

Uma estrutura MS_ADDINFO_BLOB que contém informações adicionais para tipos de assunto blob.

psDetachedSig

pClientData

Um ponteiro para dados específicos do SIP.

Comentários

Após o primeiro uso da estrutura SIP_SUBJECTINFO , inicialize toda a estrutura como zero binário. Não inicialize a estrutura entre chamadas de função SIP.

Os assuntos incluem, mas não se limitam a imagens executáveis portáteis (.exe), imagens de gabinete (.cab), arquivos simples e arquivos de catálogo. Cada tipo de assunto usa um subconjunto diferente de seus dados para cálculo de hash e requer um procedimento diferente para armazenamento e recuperação. Portanto, cada tipo de assunto tem uma especificação de pacote de interface de assunto exclusiva.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	mssip.h