CryptRegisterOIDInfo-Funktion (wincrypt.h)

Artikel
08/27/2023

Die CryptRegisterOIDInfo-Funktion registriert die in der CRYPT_OID_INFO-Struktur angegebenen OID-Informationen und speichert sie in der Registrierung.

Crypt32.dll enthält vordefinierte Informationen für die allgemein bekannten OIDs. Mit dieser Funktion können Anwendungen die vordefinierten OID-Informationen erweitern. Beim ersten Aufruf von CryptRegisterOIDInfo werden die registrierten OID-Informationen installiert.

Beim Erweitern der Tabellen mithilfe von CryptRegisterOIDInfo können die neuen Einträge entweder vor oder nach vordefinierten Einträgen platziert werden, gesteuert von dwFlags. Die Platzierung der registrierten OID-Informationen wirkt sich auf das Ergebnis von CryptFindOIDInfo aus, da die Tabellen in der richtigen Reihenfolge durchsucht werden. Zuerst registrierte Einträge platziert, bevor die vordefinierten Einträge überprüft werden, dann werden die vordefinierten Einträge überprüft, und schließlich werden registrierte Einträge nach den vordefinierten Einträgen überprüft. Die erste gefundene Übereinstimmung wird zurückgegeben. Ein neu registrierter Eintrag, der vor den vordefinierten Einträgen platziert wird, kann einen der vordefinierten Einträge außer Kraft setzen.

Syntax

BOOL CryptRegisterOIDInfo(
  [in] PCCRYPT_OID_INFO pInfo,
  [in] DWORD            dwFlags
);

Parameter

[in] pInfo

Ein Zeiger auf eine CRYPT_OID_INFO-Struktur mit den zu registrierenden OID-Informationen. Geben Sie die Gruppe an, für die die OID-Informationen registriert werden sollen, indem Sie das dwGroupId-Element der Struktur festlegen.

Hinweis

Beim Registrieren von OID-Informationen für Suite B-Algorithmen , die mit der Kryptografie-API: Nächste Generation (CNG) implementiert wurden, müssen Sie den Algid-Member der CRYPT_OID_INFO-Struktur auf CALG_OID_INFO_CNG_ONLY (0xFFFFFFFF) festlegen.

[in] dwFlags

Standardmäßig werden die registrierten OID-Informationen nach Crypt32.dll OID-Einträgen installiert. Wenn CRYPT_INSTALL_OID_INFO_BEFORE_FLAG festgelegt ist, werden neue OID-Informationen vor den Einträgen von Crypt32.dll installiert.

Rückgabewert

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

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

Hinweise

Wenn Sie die Verwendung der OID-Informationen abgeschlossen haben, heben Sie die Registrierung auf, indem Sie die Funktion CryptUnregisterOIDInfo aufrufen.

Anforderungen

Anforderung	Wert
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