CERT_CREATE_CONTEXT_PARA Struktur (wincrypt.h)

Artikel
08/27/2023

Die CERT_CREATE_CONTEXT_PARA-Struktur definiert zusätzliche Werte, die beim Aufrufen der CertCreateContext-Funktion verwendet werden können.

Syntax

typedef struct _CERT_CREATE_CONTEXT_PARA {
  DWORD                             cbSize;
  PFN_CRYPT_FREE                    pfnFree;
  void                              *pvFree;
  PFN_CERT_CREATE_CONTEXT_SORT_FUNC pfnSort;
  void                              *pvSort;
} CERT_CREATE_CONTEXT_PARA, *PCERT_CREATE_CONTEXT_PARA;

Member

cbSize

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

pfnFree

Ein Zeiger auf die Funktion, die den pbEncoded-Parameter der CertCreateContext-Funktion freigibt. Die pfnFree-Funktion wird aufgerufen, wenn der von CertCreateContext erstellte Kontext freigegeben wird. Dieser Wert kann NULL sein. In diesem Fall wird der pbEncoded-Parameter der CertCreateContext-Funktion nicht freigegeben.

pvFree

Die Adresse des Arbeitsspeichers, der von der pfnFree-Funktion freigegeben wird. Wenn pvFreeNULL ist, wird der pbEncoded-Parameter der CertCreateContext-Funktion freigegeben.

pfnSort

Ein PFN_CERT_CREATE_CONTEXT_SORT_FUNC Funktionszeiger, der für jeden sortierten Kontexteintrag aufgerufen wird.

Dieses Element ist nur für eine CERT_STORE_CTL_CONTEXT vorhanden, wenn das CERT_CREATE_CONTEXT_SORTED_FLAG-Flag im dwFlags-Parameter der CertCreateContext-Funktion festgelegt ist. Sie müssen überprüfen, ob dieser Member vorhanden ist, bevor Sie versuchen, darauf zuzugreifen, indem Sie das cbSize-Element dieser Struktur untersuchen.

pvSort

Ein anwendungsdefinierter Wert, der im pvSort-Parameter der PFN_CERT_CREATE_CONTEXT_SORT_FUNC Rückruffunktion übergeben wird.

Anforderungen


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

Weitere Informationen

CertCreateContext

PFN_CERT_CREATE_CONTEXT_SORT_FUNC

Share via