CryptGetDefaultOIDDllList-Funktion (wincrypt.h)

Artikel
08/27/2023

Die CryptGetDefaultOIDDllList-Funktion ruft die Liste der Namen von DLL-Dateien ab, die registrierte OID-Funktionen (Default Object Identifier ) für einen angegebenen Funktionssatz und Codierungstyp enthalten.

Syntax

BOOL CryptGetDefaultOIDDllList(
  [in]      HCRYPTOIDFUNCSET hFuncSet,
  [in]      DWORD            dwEncodingType,
  [out]     WCHAR            *pwszDllList,
  [in, out] DWORD            *pcchDllList
);

Parameter

[in] hFuncSet

Funktionssatzhandle, das zuvor durch einen Aufruf von CryptInitOIDFunctionSet abgerufen wurde.

[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

Hinweis Es ist entweder ein Zertifikat oder ein Nachrichtencodierungstyp erforderlich. X509_ASN_ENCODING ist die Standardeinstellung. Wenn dieser Typ angegeben ist, wird er verwendet; Wenn andernfalls der PKCS7_ASN_ENCODING Typ angegeben wird, wird er verwendet.

[out] pwszDllList

Ein Zeiger auf einen Puffer, um die Liste der null oder mehr null-beendeten Dateinamen zu empfangen. Die zurückgegebene Liste wird mit einem beendenden NULL-Zeichen beendet. Eine Liste mit zwei Namen kann beispielsweise wie folgt aussehen:

L"first.dll\0" L"second.dll\0" L"\0"

Um die Anzahl der Breitzeichen abzurufen, die der Puffer enthalten muss, kann dieser Parameter NULL sein. Weitere Informationen finden Sie unter Abrufen von Daten mit unbekannter Länge.

[in, out] pcchDllList

Ein Zeiger auf ein DWORD , der die Größe der zurückgegebenen Liste in Breitzeichen angibt, auf die der pwszDllList-Parameter verweist. Wenn die Funktion zurückgibt, enthält die Variable, auf die der parameter pcchDllList verweist, die Anzahl der im Puffer gespeicherten Breitzeichen.

Hinweis Bei der Verarbeitung der im Puffer zurückgegebenen Daten müssen Anwendungen die tatsächliche Größe der zurückgegebenen Daten verwenden. Die tatsächliche Größe kann etwas kleiner als die Größe des bei der Eingabe angegebenen Puffers sein. Bei der Eingabe werden Puffergrößen in der Regel groß genug angegeben, um sicherzustellen, dass die größtmöglichen Ausgabedaten in den Puffer passen. Bei der Ausgabe wird die Variable aktualisiert, auf die dieser Parameter verweist, um die tatsächliche Größe der in den Puffer kopierten Daten widerzuspiegeln.

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. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.

Diese Funktion weist die folgenden Fehlercodes auf.

Rückgabecode	Beschreibung
ERROR_MORE_DATA	Wenn der vom parameter pwszDllList angegebene Puffer nicht groß genug ist, um die zurückgegebenen Daten zu speichern, legt die Funktion den ERROR_MORE_DATA Code fest und speichert die erforderliche Puffergröße in Breitzeichen in der Variablen, auf die von pcchDllList verwiesen wird.

Anforderungen


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