CertRegisterPhysicalStore-Funktion (wincrypt.h)

Artikel
08/27/2023

Die CertRegisterPhysicalStore-Funktion fügt einer Sammlung des Registrierungssystemspeichers einen physischen Speicher hinzu.

Syntax

BOOL CertRegisterPhysicalStore(
  [in] const void                *pvSystemStore,
  [in] DWORD                     dwFlags,
  [in] LPCWSTR                   pwszStoreName,
  [in] PCERT_PHYSICAL_STORE_INFO pStoreInfo,
  [in] void                      *pvReserved
);

Parameter

[in] pvSystemStore

Die Systemspeicherauflistung, der der physische Speicher hinzugefügt wird. Dieser Parameter verweist entweder auf eine Unicode-Zeichenfolge mit Null-Beendigung oder auf eine CERT_SYSTEM_STORE_RELOCATE_PARA-Struktur . Informationen zur Verwendung der -Struktur und zum Hinzufügen von ServiceName oder ComputerName vor der Systemspeichernamenzeichenfolge finden Sie unter CertRegisterSystemStore.

[in] dwFlags

Das hohe Wort des dwFlags-Parameters gibt den Speicherort des Systemspeichers an. Informationen zu definierten High-Word-Flags und dem Anfügen von ServiceName, UserNames und ComputerNames am Ende des Systemspeichernamens finden Sie unter CertRegisterSystemStore.

Die folgenden Low-Word-Flags sind ebenfalls definiert und können mithilfe eines bitweisen OR-Vorgangs mit High-Word-Flags kombiniert werden.

Wert	Bedeutung
CERT_SYSTEM_STORE_RELOCATE_FLAG	Der Systemspeicher befindet sich nicht im Standardregistrierungsspeicherort, und der parameter pvSystemStore muss ein Zeiger auf eine CERT_SYSTEM_STORE_RELOCATE_PARA-Struktur sein.
CERT_STORE_CREATE_NEW_FLAG	Die Funktion schlägt fehl, wenn der physische Speicher bereits am Speicherort vorhanden ist.

[in] pwszStoreName

Ein Zeiger auf eine Unicode-Zeichenfolge, die den physischen Speicher benennt, der der Systemspeichersammlung hinzugefügt werden soll. Um einen physischen Speicher aus der Systemspeichersammlung zu entfernen, rufen Sie die Funktion CertUnregisterPhysicalStore auf.

[in] pStoreInfo

Ein Zeiger auf eine CERT_PHYSICAL_STORE_INFO-Struktur , die grundlegende Informationen zum physischen Speicher bereitstellt.

[in] pvReserved

Reserviert für die zukünftige Verwendung und muss auf NULL festgelegt werden.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion nonzero zurück.

Wenn die Funktion fehlschlägt, gibt sie null zurück.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wincrypt.h
Bibliothek	Crypt32.lib
DLL	Crypt32.dll