CERT_PHYSICAL_STORE_INFO-Struktur (wincrypt.h)
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 |
|---|---|
|
Aktiviert das Hinzufügen eines Kontexts zum Speicher. |
|
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. |
|
Deaktiviert das Remoteöffnen des physischen Speichers. |
|
Places die Zeichenfolge \\ComputerName vor anderen Anbietertypen. |
|
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 |