CryptInstallOIDFunctionAddress-Funktion (wincrypt.h)

Artikel
03/03/2024

Die CryptInstallOIDFunctionAddress-Funktion installiert eine Reihe von OID-Funktionsadressen (Callable Object Identifier ).

Syntax

BOOL CryptInstallOIDFunctionAddress(
  [in] HMODULE                       hModule,
  [in] DWORD                         dwEncodingType,
  [in] LPCSTR                        pszFuncName,
  [in] DWORD                         cFuncEntry,
  [in] const CRYPT_OID_FUNC_ENTRY [] rgFuncEntry,
  [in] DWORD                         dwFlags
);

Parameter

[in] hModule

Dieser Parameter wird mit dem hModule-Parameter aktualisiert, der an DllMain übergeben wird, um zu verhindern, dass die DLL, die die Funktionsadressen enthält, von CryptGetOIDFunctionAddress oder CryptFreeOIDFunctionAddress entladen wird. Dies wäre der Fall, wenn die DLL auch OID-Funktionen über CryptRegisterOIDFunction registriert hat.

[in] dwEncodingType

Gibt den abzugleichenden Codierungstyp an. Derzeit werden nur X509_ASN_ENCODING und PKCS_7_ASN_ENCODING verwendet. In Zukunft können jedoch weitere Codierungstypen hinzugefügt werden. Um beide aktuellen Codierungstypen abzugleichen, verwenden Sie Folgendes:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING

[in] pszFuncName

Name des Zu installierenden Funktionssatzes.

[in] cFuncEntry

Anzahl der Arrayelemente in rgFuncEntry[].

[in] rgFuncEntry

Array von CRYPT_OID_FUNC_ENTRY Strukturen, die jeweils eine OID und die Startadresse ihrer korrelierten Routine enthalten.

Standardfunktionen werden installiert, indem der pszOID-Member der CRYPT_OID_FUNC_ENTRY-Struktur für deren Arrayelement auf CRYPT_DEFAULT_OID festgelegt wird.

[in] dwFlags

Standardmäßig wird am Ende der Liste der Funktionssätze ein neuer Funktionssatz installiert. Durch Festlegen des CRYPT_INSTALL_OID_FUNC_BEFORE_FLAG-Flags wird die am Anfang der Liste festgelegte Funktion installiert.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion ungleich null (TRUE) zurück.

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

Anforderungen

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

Weitere Informationen

CRYPT_OID_FUNC_ENTRY

OID-Unterstützungsfunktionen

Freigeben über