CryptEnumOIDFunction-Funktion (wincrypt.h)

Die CryptEnumOIDFunction-Funktion listet die OID-Funktionen (Registered Object Identifier ) auf. OID-Funktionen, die aufgelistet werden, können so überprüft werden, dass sie diejenigen enthalten, die durch ihren Codierungstyp, funktionsnamen, OID oder eine beliebige Kombination aus Codierungstyp, Funktionsname und OID identifiziert werden. Für jede OID-Funktion, die den Auswahlkriterien entspricht, wird eine von der Anwendung bereitgestellte Rückruffunktion , pfnEnumOIDFunc, aufgerufen.

Syntax

BOOL CryptEnumOIDFunction(
  [in] DWORD                   dwEncodingType,
  [in] LPCSTR                  pszFuncName,
  [in] LPCSTR                  pszOID,
  [in] DWORD                   dwFlags,
  [in] void                    *pvArg,
  [in] PFN_CRYPT_ENUM_OID_FUNC pfnEnumOIDFunc
);

Parameter

[in] dwEncodingType

Gibt den zu übereinstimmenden Codierungstyp an. Das Festlegen dieses Parameters auf CRYPT_MATCH_ANY_ENCODING_TYPE entspricht einem beliebigen Codierungstyp. Beachten Sie, dass, wenn CRYPT_MATCH_ANY_ENCODING_TYPE nicht angegeben wird, entweder ein Zertifikat- oder Nachrichtencodierungstyp erforderlich ist. Wenn das Wort mit niedriger Reihenfolge, das den Zertifikatcodierungstyp enthält, nichtzero ist, wird es verwendet. Andernfalls wird das hochgeordnete Wort verwendet, das den Nachrichtencodierungstyp enthält. Wenn beide angegeben sind, wird der Zertifikatcodierungstyp im Wort mit niedriger Reihenfolge verwendet.

Derzeit definierte Codierungstypen sind:

• CRYPT_ASN_ENCODING
• X509_ASN_ENCODING
• PKCS_7_ASN_ENCODING
• CRYPT_MATCH_ANY_ENCODING_TYPE

[in] pszFuncName

Name einer Funktion, bei der eine Übereinstimmungssuche ohne Beachtung der Groß-/Kleinschreibung durchgeführt wird. Wenn Sie diesen Parameter auf NULL festlegen, wird eine Übereinstimmung für einen beliebigen Funktionsnamen gefunden.

[in] pszOID

Wenn das Wort "pszOID " in hoher Reihenfolge nonzero ist, gibt pszOID den Objektbezeichner an, für den eine Übereinstimmung ohne Beachtung der Groß-/Kleinschreibung durchgeführt wird. Wenn das Wort " pszOID " in hoher Reihenfolge null ist, wird "pszOID " verwendet, um einen numerischen Objektbezeichner zuzuordnen. Wenn Sie diesen Parameter auf NULL festlegen, stimmt jeder Objektbezeichner überein. Wenn Sie diesen Parameter auf CRYPT_DEFAULT_OID festlegen, wird die Enumeration nur auf die Standardfunktionen beschränkt.

[in] dwFlags

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

[in] pvArg

Ein Zeiger auf Argumente, die an die CRYPT_ENUM_OID_FUNCTION Rückruffunktion übergeben werden sollen.

[in] pfnEnumOIDFunc

Ein Zeiger auf die Rückruffunktion, die für jede OID-Funktion ausgeführt wird, die den Eingabeparametern entspricht. Ausführliche Informationen finden Sie unter CRYPT_ENUM_OID_FUNCTION.

Rückgabewert

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

Wenn die Funktion fehlschlägt, gibt sie null (FALSE) zurück. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.

Anforderungen

Weitere Informationen

OID-Unterstützungsfunktionen