CryptCATPersistStore-Funktion (mscat.h)
[Die CryptCATPersistStore-Funktion steht für die Verwendung in den Betriebssystemen zur Verfügung, die im Abschnitt Anforderungen angegeben sind. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]
Die CryptCATPersistStore-Funktion speichert die Informationen im angegebenen Katalogspeicher in einer nicht signierten Katalogdatei.
Syntax
BOOL CryptCATPersistStore(
[in] HANDLE hCatalog
);
Parameter
[in] hCatalog
Ein Handle für den Katalog, der von der Funktion CryptCATHandleFromStore oder der CryptCATOpen-Funktion abgerufen wurde. Ab Windows 8 müssen Sie nur CryptCATOpen verwenden, um ein Handle abzurufen.
Rückgabewert
Der Rückgabewert ist TRUE , wenn die Funktion erfolgreich ist. andernfalls FALSE.
Wenn diese Funktion FALSE zurückgibt, können zusätzliche Fehlerinformationen abgerufen werden, indem die GetLastError-Funktion aufgerufen wird. GetLastError gibt den folgenden Fehlercode zurück.
Rückgabecode | Beschreibung |
---|---|
|
Mindestens ein Parameter ist ungültig. |
|
Ab Windows 8 und Windows Server 2012 müssen Sie ein Handle abrufen, indem Sie die CryptCATOpen-Funktion aufrufen, wobei der dwPublicVersion-Parameter auf 0x100 oder 0x200 festgelegt ist. Weitere Informationen finden Sie in den Hinweisen. |
Hinweise
Die CRYPTCATSTORE-Struktur muss initialisiert werden, bevor Sie CryptCATPersistStore aufrufen.
Ab Windows 8 und Windows Server 2012 gelten die folgenden Änderungen für diese Funktion:
- Wenn CryptCATOpen mit dem dwPublicVersion-Parameter 0x200 aufgerufen wurde, wird der Katalog im v2-Format geschrieben.
- Wenn CryptCATOpen mit dem dwPublicVersion-Parameter 0x100 aufgerufen wurde, wird der Katalog im v1-Format geschrieben.
- Wenn CryptCATOpen mit einem anderen dwPublicVersion-Parameter als 0x200 oder 0x100 aufgerufen wurde, gibt die CryptCATPersistStore-FunktionFALSE zurück, und der Fehlercode ist auf ERROR_NOT_SUPPORTED festgelegt.
Anforderungen
Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | mscat.h |
Bibliothek | Wintrust.lib |
DLL | Wintrust.dll |