struttura SIP_DISPATCH_INFO (mssip.h)

Articolo
08/25/2023

La struttura SIP_DISPATCH_INFO contiene un set di puntatori a funzione assegnati dalla funzione CryptSIPLoad usata dall'applicazione per eseguire operazioni SIP ( Subject Interface Package ).

Sintassi

typedef struct SIP_DISPATCH_INFO_ {
  DWORD                        cbSize;
  HANDLE                       hSIP;
  pCryptSIPGetSignedDataMsg    pfGet;
  pCryptSIPPutSignedDataMsg    pfPut;
  pCryptSIPCreateIndirectData  pfCreate;
  pCryptSIPVerifyIndirectData  pfVerify;
  pCryptSIPRemoveSignedDataMsg pfRemove;
} SIP_DISPATCH_INFO, *LPSIP_DISPATCH_INFO;

Members

cbSize

Dimensione, in byte, della struttura.

hSIP

Questo membro è riservato e deve essere impostato su NULL.

pfGet

Puntatore alla funzione che recupera i dati firmati per l'oggetto. La firma per questo puntatore a funzione è descritta in CryptSIPGetSignedDataMsg.

pfPut

Puntatore alla funzione che archivia i dati firmati per l'oggetto. La firma per questo puntatore a funzione è descritta in CryptSIPPutSignedDataMsg.

pfCreate

Puntatore alla funzione che restituisce una struttura SIP_INDIRECT_DATA che contiene i dati dell'interessato. Questa struttura contiene l'hash della destinazione. La firma per questo puntatore a funzione è descritta in CryptSIPCreateIndirectData.

pfVerify

Puntatore alla funzione che verifica la struttura SIP_INDIRECT_DATA che contiene i dati dell'interessato. Questa struttura contiene l'hash della destinazione. La firma per questo puntatore a funzione è descritta in CryptSIPVerifyIndirectData.

pfRemove

Puntatore alla funzione che rimuove i dati firmati per l'oggetto. La firma per questo puntatore a funzione è descritta in CryptSIPRemoveSignedDataMsg.

Commenti

L'applicazione deve inizializzare questa struttura in zeri binari e impostare cbSize su sizeof(SIP_DISPATCH_INFO) chiamando la funzione memset prima di chiamare la funzione CryptSIPLoad . L'applicazione può usare i puntatori a funzione nella struttura SIP_DISPATCH_INFO restituita per eseguire le operazioni SIP necessarie. I puntatori a funzione possono puntare a funzioni esportate da SIP di terze parti.