CertUnregisterPhysicalStore-Funktion (wincrypt.h)

Artikel
08/27/2023

Die CertUnregisterPhysicalStore-Funktion entfernt einen physischen Speicher aus einer angegebenen Systemspeichersammlung. CertUnregisterPhysicalStore kann auch zum Löschen des physischen Speichers verwendet werden.

Syntax

BOOL CertUnregisterPhysicalStore(
  [in] const void *pvSystemStore,
  [in] DWORD      dwFlags,
  [in] LPCWSTR    pwszStoreName
);

Parameter

[in] pvSystemStore

Ein Zeiger auf einen Bezeichner der Systemspeichersammlung, aus der der physische Speicher entfernt werden soll. Es handelt sich entweder um eine Unicode-Zeichenfolge mit NULL-Termin oder um eine CERT_SYSTEM_STORE_RELOCATE_PARA-Struktur . Informationen zur Verwendung der -Struktur und zum Anfügen von ServiceName oder ComputerName am Ende 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 zum Anfügen von ServiceName, UserNames und ComputerNames am Ende des Systemspeichernamens finden Sie unter CertRegisterSystemStore.

Die folgenden Low-Word-Werte werden ebenfalls definiert. Sie können mithilfe bitweiser OR-Operationen mit hohen Wortwerten kombiniert werden.

Wert	Bedeutung
CERT_SYSTEM_STORE_RELOCATE_FLAG	Der Systemspeicher befindet sich nicht am Standardregistrierungsspeicherort, und pvSystemStore muss ein Zeiger auf eine CERT_SYSTEM_STORE_RELOCATE_PARA-Struktur sein.
CERT_STORE_DELETE_FLAG	Der physische Speicher wird zuerst aus der Systemspeichersammlung entfernt und dann gelöscht.

[in] pwszStoreName

Mit Null beendete Unicode-Zeichenfolge, die den Namen des physischen Speichers enthält.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE.

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