CryptSetOIDFunctionValue-Funktion (wincrypt.h)

Artikel
03/03/2024

Die CryptSetOIDFunctionValue-Funktion legt einen Wert für den angegebenen Codierungstyp, Funktionsnamen, OID und Wertnamen fest.

Syntax

BOOL CryptSetOIDFunctionValue(
  [in] DWORD      dwEncodingType,
  [in] LPCSTR     pszFuncName,
  [in] LPCSTR     pszOID,
  [in] LPCWSTR    pwszValueName,
  [in] DWORD      dwValueType,
  [in] const BYTE *pbValueData,
  [in] DWORD      cbValueData
);

Parameter

[in] dwEncodingType

Gibt den zu übereinstimmenden Codierungstyp an. Derzeit werden nur X509_ASN_ENCODING und PKCS_7_ASN_ENCODING verwendet. Es können jedoch in Zukunft weitere Codierungstypen hinzugefügt werden. Verwenden Sie folgendes, um beide aktuellen Codierungstypen abzugleichen:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING.

[in] pszFuncName

Name der Funktion, für die der Codierungstyp, die OID und der Wertname aktualisiert werden.

[in] pszOID

Wenn das Wort der hohen Ordnung des Objektbezeichners (OID) nichtzero ist, ist pszOID ein Zeiger auf eine OID-Zeichenfolge wie "2.5.29.1" oder eine ASCII-Zeichenfolge wie "file". Wenn das Wort mit hoher Ordnung der OID 0 ist, gibt das Wort mit niedriger Reihenfolge den ganzzahligen Bezeichner an, der als Objektbezeichner verwendet werden soll.

[in] pwszValueName

Ein Zeiger auf eine Unicode-Zeichenfolge, die den Namen des festzulegenden Werts enthält. Wenn ein Wert mit diesem Namen noch nicht vorhanden ist, wird er von der Funktion erstellt.

[in] dwValueType

Gibt den Typ der Informationen an, die als Daten des Werts gespeichert werden sollen. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
REG_DWORD	Eine 32-Bit-Zahl.
REG_EXPAND_SZ	Eine Unicode-Zeichenfolge mit Null-Endung, die nicht erweitere Verweise auf Umgebungsvariablen enthält (z. B. "%PATH%").
REG_MULTI_SZ	Ein Array von Unicode-Zeichenfolgen mit NULL-Terminen, das durch zwei NULL-Zeichen beendet wird.
REG_SZ	Eine null-terminierte Unicode-Zeichenfolge.

[in] pbValueData

Verweist auf einen Puffer, der die Daten enthält, die für den angegebenen Wertnamen gespeichert werden sollen.

[in] cbValueData

Gibt die Größe der Informationen in Bytes an, auf die der pbValueData-Parameter verweist. Wenn die Daten vom Typ REG_SZ, REG_EXPAND_SZ oder REG_MULTI_SZ sind, muss die Größe das beendende NULL-Breitzeichen enthalten.

Rückgabewert

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

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

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

Weitere Informationen

OID-Unterstützungsfunktionen

Freigeben über