Freigeben über

CryptCATPutAttrInfo-Funktion (mscat.h)

  • Artikel

[Die CryptCATPutAttrInfo-Funktion ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Die CryptCATPutAttrInfo-Funktion ordnet Arbeitsspeicher für ein Attribut zu und fügt ihn einem Katalogelement hinzu.

Syntax

CRYPTCATATTRIBUTE * CryptCATPutAttrInfo(
  [in] HANDLE         hCatalog,
  [in] CRYPTCATMEMBER *pCatMember,
  [in] LPWSTR         pwszReferenceTag,
  [in] DWORD          dwAttrTypeAndAction,
  [in] DWORD          cbData,
  [in] BYTE           *pbData
);

Parameter

[in] hCatalog

Ein Handle für den Katalog, der von der Funktion CryptCATOpen oder CryptCATHandleFromStore abgerufen wurde.

[in] pCatMember

Ein Zeiger auf eine CRYPTCATMEMBER-Struktur , die den Katalogmember enthält.

[in] pwszReferenceTag

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des Attributs enthält.

[in] dwAttrTypeAndAction

Ein -Wert, der eine bitweise Kombination der folgenden Flags darstellt. Der Aufrufer muss mindestens CRYPTCAT_ATTR_DATABASE64 oder CRYPTCAT_ATTR_DATAASCII angeben.

Wert Bedeutung
CRYPTCAT_ATTR_AUTHENTICATED
0x10000000
 Das Attribut wird authentifiziert.
CRYPTCAT_ATTR_UNAUTHENTICATED
0x20000000
 Das Attribut ist nicht authentifiziert.
CRYPTCAT_ATTR_NAMEASCII
0x00000001
 Das Attribut ist eine ASCII-Zeichenfolge.
CRYPTCAT_ATTR_NAMEOBJID
0x00000002
 Das Attribut ist ein kryptografischer Objektbezeichner (Cryptographic Object Identifier , OID).
CRYPTCAT_ATTR_DATAASCII
0x00010000
 Das Attribut enthält einfache ASCII-Zeichen, die nicht decodiert werden sollen.
CRYPTCAT_ATTR_DATABASE64
0x00020000
 Das Attribut hat das Basis-64-Format.
CRYPTCAT_ATTR_DATAREPLACE
0x00040000
 Das -Attribut ersetzt den Wert für ein vorhandenes Attribut.

[in] cbData

Ein -Wert, der die Anzahl der Bytes im pbData-Puffer angibt.

[in] pbData

Ein Zeiger auf einen Speicherpuffer, der den Attributwert enthält.

Rückgabewert

Bei erfolgreicher Ausführung gibt diese Funktion einen Zeiger auf eine CRYPTCATATTRIBUTE-Struktur zurück, die das zugewiesene Attribut enthält. Der Aufrufer darf diesen Zeiger oder seine Member nicht freigeben.

Wenn diese Funktion NULL zurückgibt, können zusätzliche Fehlerinformationen durch Aufrufen der GetLastError-Funktion abgerufen werden. GetLastError gibt einen der folgenden Fehlercodes zurück.

Rückgabecode Beschreibung
ERROR_INVALID_PARAMETER
 Mindestens ein Parameter ist ungültig.
ERROR_NOT_ENOUGH_MEMORY
 Beim Betriebssystem ist während des Vorgangs nicht mehr genügend Arbeitsspeicher vorhanden.

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 mscat.h
Bibliothek Wintrust.lib
DLL Wintrust.dll