CERT_PHYSICAL_STORE_INFO-Struktur (wincrypt.h)

Artikel
08/27/2023

Die CERT_PHYSICAL_STORE_INFO-Struktur enthält Informationen zu physischen Zertifikatspeichern. Einige Member dieser Strukturen werden direkt an Systemaufrufe von CertOpenStore übergeben, um den physischen Speicher zu öffnen.

Syntax

typedef struct _CERT_PHYSICAL_STORE_INFO {
  DWORD           cbSize;
  LPSTR           pszOpenStoreProvider;
  DWORD           dwOpenEncodingType;
  DWORD           dwOpenFlags;
  CRYPT_DATA_BLOB OpenParameters;
  DWORD           dwFlags;
  DWORD           dwPriority;
} CERT_PHYSICAL_STORE_INFO, *PCERT_PHYSICAL_STORE_INFO;

Member

cbSize

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

pszOpenStoreProvider

Ein Zeiger auf eine Zeichenfolge, die einen Zertifikatspeicheranbietertyp benennt. Diese Zeichenfolge wird in einem Systemaufruf an CertOpenStore übergeben und bestimmt den Anbietertyp eines zu öffnenden Zertifikatspeichers. Die Namen vordefinierter Zertifikatspeichertypen finden Sie unter CertOpenStore.

Zusätzlich zu vordefinierten Zertifikatspeicheranbietertypen können neue Speicheranbietertypen installiert und mit CryptInstallOIDFunctionAddress oder CryptRegisterOIDFunction registriert werden. Weitere Informationen finden Sie unter CertOpenStore.

dwOpenEncodingType

Dieser Member gilt nur, wenn CERT_STORE_PROV_MSG, CERT_STORE_PROV_PKCS7 oder CERT_STORE_PROV_FILENAME in lpszStoreProvider übergeben wird. Andernfalls wird dieser Member nicht verwendet.

Es ist immer akzeptabel, sowohl den Zertifikat- als auch den Nachrichtencodierungstyp anzugeben, indem sie mit einem bitweisen OR-Vorgang kombiniert werden, wie im folgenden Beispiel gezeigt:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING Derzeit definierte Codierungstypen sind:

X509_ASN_ENCODING
PKCS_7_ASN_ENCODING

dwOpenFlags

Wenn ein Systemspeicher mit dem Speicherort SERVICES oder USERS geöffnet wird, wird der dwOpenFlags-Speicherort auf CERT_SYSTEM_STORE_USERS oder CERT_SYSTEM_STORE_SERVICES festgelegt.

OpenParameters

Eine CRYPT_DATA_BLOB , die Daten enthält, die an den pvPara-Parameter der CertOpenStore-Funktion übergeben werden sollen. Der Datentyp hängt vom angegebenen Anbieter ab. Ausführliche Informationen zum Typ und zum zu übergebenden Inhalt finden Sie unter Beschreibungen der verfügbaren Anbieter in CertOpenStore.

dwFlags

Die folgenden dwFlags-Werte für CERT_PHYSICAL_STORE_INFO werden definiert.

Wert	Bedeutung
CERT_PHYSICAL_STORE_ADD_ENABLE_FLAG	Aktiviert das Hinzufügen eines Kontexts zum Speicher.
CERT_PHYSICAL_STORE_OPEN_DISABLE_FLAG	Wird durch die CertRegisterPhysicalStore-Funktion festgelegt. Standardmäßig verfügen alle Systemspeicher in der Registrierung über einen impliziten physischen SystemRegistry-Speicher, der geöffnet wird. Um das Öffnen dieses Speichers zu deaktivieren, muss der physische SystemRegistry-Speicher, der dem Systemspeicher entspricht, durch Festlegen CERT_PHYSICAL_STORE_OPEN_DISABLE_FLAG oder durch Registrieren eines physischen Speichers namens " registriert werden. Default" mit CertRegisterPhysicalStore.
CERT_PHYSICAL_STORE_REMOTE_OPEN_DISABLE_FLAG	Deaktiviert das Remoteöffnen des physischen Speichers.
CERT_PHYSICAL_STORE_INSERT_COMPUTER_NAME_ENABLE_FLAG	Places die Zeichenfolge \\ComputerName vor anderen Anbietertypen.
CERT_SYSTEM_STORE_RELOCATE_FLAG	Ermöglicht CertOpenStore das Öffnen eines Speichers relativ zu einem vom Benutzer angegebenen HKEY anstelle einer der vordefinierten HKEY-Konstanten. Beispielsweise kann HKEY_CURRENT_USER durch einen vom Benutzer angegebenen HKEY ersetzt werden. Wenn CERT_SYSTEM_STORE_RELOCATE_FLAG festgelegt ist, verweist der an CertOpenStore übergebene pvPara-Parameter auf eine CERT_SYSTEM_STORE_RELOCATE_PARA-Struktur, anstatt auf den Speichernamen als null-endende Unicode - oder ASCII-Zeichenfolge zu zeigen.

dwPriority

Wenn ein Systemspeicher geöffnet wird, werden seine physischen Speicher gemäß ihren dwPriority-Einstellungen sortiert. Eine höhere dwPriority gibt eine höhere Priorität an. Das dwPriority-Element wird an CertAddStoreToCollection übergeben.

Anforderungen

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

Weitere Informationen

CertAddStoreToCollection

CertOpenStore

CertRegisterPhysicalStore

CryptInstallOIDFunctionAddress

CryptRegisterOIDFunction

Share via