CryptGetDefaultOIDFunctionAddress-Funktion (wincrypt.h)

Artikel
03/06/2024

Die Funktion CryptGetDefaultOIDFunctionAddress lädt die DLL, die eine Standardfunktionsadresse enthält. Es kann auch die Adresse der ersten oder der nächsten installierten Standardobjektbezeichnerfunktion (OID) in einem initialisierten Funktionssatz zurückgeben und die DLL laden, die die Adresse dieser Funktion enthält.

Syntax

BOOL CryptGetDefaultOIDFunctionAddress(
  [in]           HCRYPTOIDFUNCSET  hFuncSet,
  [in]           DWORD             dwEncodingType,
  [in, optional] LPCWSTR           pwszDll,
  [in]           DWORD             dwFlags,
  [out]          void              **ppvFuncAddr,
  [in, out]      HCRYPTOIDFUNCADDR *phFuncAddr
);

Parameter

[in] hFuncSet

Funktionssatzhandle, das zuvor aus einem Aufruf von CryptInitOIDFunctionSet abgerufen wurde.

[in] dwEncodingType

Abzugleichende Codierungstyp. 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, optional] pwszDll

Name der zu ladenden DLL. Normalerweise wird der DLL-Name aus der Liste abgerufen, die von CryptGetDefaultOIDDllList zurückgegeben wird. Wenn pwszDllNULL ist, wird eine Suche für die Liste der installierten Standardfunktionen ausgeführt.

[in] dwFlags

Für die zukünftige Verwendung reserviert und muss null sein.

[out] ppvFuncAddr

Ein Zeiger auf die Adresse der Rückgabefunktion. Wenn die Funktion fehlschlägt, wird in ppvFuncAddr ein NULL-Wert zurückgegeben.

[in, out] phFuncAddr

Wird nur verwendet, wenn pwszDllNULL ist. Beim ersten Aufruf der Funktion muss *phFuncAddrNULL sein, um die erste installierte Funktion abzurufen.

Wenn diese Funktion erfolgreich ist, wird *phFuncAddr auf ein Funktionshandle festgelegt. Die Verweisanzahl für das Funktionshandle wird erhöht.

Nach dem ersten Aufruf der Funktion wird phFuncAddr auf den Zeiger festgelegt, der vom vorherigen Aufruf zurückgegeben wurde. Dieser Eingabezeiger wird in der Funktion immer durch einen Aufruf von CryptFreeOIDFunctionAddress durch diese Funktion freigegeben. Der Aufruf zum Freigeben des Zeigers erfolgt immer, auch wenn die Standard-Funktion einen Fehler zurückgibt.

Ein phFuncAddr-Wert ungleich NULL muss entweder durch einen Aufruf von CryptFreeOIDFunctionAddress oder als Eingabe an diese Funktion oder als Eingabe an CryptGetOIDFunctionAddress zurückgegeben werden.

Wenn pwszDll nicht NULL ist, wird der Wert dieses Parameters ignoriert, und ein Zeiger ohne NULL wird nicht freigegeben.

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

OID-Unterstützungsfunktionen

Freigeben über