Freigeben über


CryptSetOIDFunctionValue-Funktion (wincrypt.h)

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