SIP_DISPATCH_INFO-Struktur (mssip.h)

Die SIP_DISPATCH_INFO-Struktur enthält eine Reihe von Funktionszeigern, die von der CryptSIPLoad-Funktion zugewiesen werden, die Ihre Anwendung zum Ausführen von SIP-Vorgängen ( Subject Interface Package ) verwendet.

Syntax

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;

Member

cbSize

Die Größe (in Bytes) dieser Struktur.

hSIP

Dieser Member ist reserviert und muss auf NULL festgelegt werden.

pfGet

Ein Zeiger auf die Funktion, die die signierten Daten für den Antragsteller abruft. Die Signatur für diesen Funktionszeiger wird in CryptSIPGetSignedDataMsg beschrieben.

pfPut

Ein Zeiger auf die Funktion, die die signierten Daten für den Antragsteller speichert. Die Signatur für diesen Funktionszeiger wird in CryptSIPPutSignedDataMsg beschrieben.

pfCreate

Ein Zeiger auf die Funktion, die eine SIP_INDIRECT_DATA-Struktur zurückgibt, die die Daten des Antragstellers enthält. Diese Struktur enthält den Hash des Ziels. Die Signatur für diesen Funktionszeiger wird in CryptSIPCreateIndirectData beschrieben.

pfVerify

Ein Zeiger auf die Funktion, die die SIP_INDIRECT_DATA Struktur überprüft, die die Daten des Antragstellers enthält. Diese Struktur enthält den Hash des Ziels. Die Signatur für diesen Funktionszeiger wird in CryptSIPVerifyIndirectData beschrieben.

pfRemove

Ein Zeiger auf die Funktion, die die signierten Daten für den Antragsteller entfernt. Die Signatur für diesen Funktionszeiger wird in CryptSIPRemoveSignedDataMsg beschrieben.

Hinweise

Ihre Anwendung muss diese Struktur auf binäre Nullen initialisieren und cbSize auf sizeof(SIP_DISPATCH_INFO) festlegen, indem die Memset-Funktion aufgerufen wird, bevor die CryptSIPLoad-Funktion aufgerufen wird. Ihre Anwendung kann die Funktionszeiger in der zurückgegebenen SIP_DISPATCH_INFO Struktur verwenden, um die erforderlichen SIP-Vorgänge auszuführen. Die Funktionszeiger können auf Funktionen verweisen, die von DRITTANBIETER-SIPs exportiert werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	mssip.h

Weitere Informationen

CryptSIPCreateIndirectData

CryptSIPGetSignedDataMsg

CryptSIPPutSignedDataMsg

CryptSIPRemoveSignedDataMsg

CryptSIPVerifyIndirectData