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 |
|---|---|
|
Não há informações adicionais sobre o assunto. |
|
As informações adicionais são um arquivo simples. |
|
As informações adicionais são um membro do catálogo. |
|
As informações adicionais são um BLOB. |
|
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 |