CertRegisterPhysicalStore-Funktion (wincrypt.h)
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 |
|---|---|
|
Der Systemspeicher befindet sich nicht im Standardregistrierungsspeicherort, und der parameter pvSystemStore muss ein Zeiger auf eine CERT_SYSTEM_STORE_RELOCATE_PARA-Struktur sein. |
|
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 |