Freigeben über

CryptCATPutCatAttrInfo-Funktion (mscat.h)

  • Artikel

[Die CryptCATPutCatAttrInfo-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 CryptCATPutCatAttrInfo-Funktion ordnet Arbeitsspeicher für ein Katalogdateiattribut zu und fügt ihn dem Katalog hinzu.

Syntax

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

Parameter

[in] hCatalog

Ein Handle für den Katalog, der von den Funktionen CryptCATOpen oder CryptCATHandleFromStore abgerufen wird.

[in] pwszReferenceTag

Ein Zeiger auf eine NULL-endende Zeichenfolge für den Namen des Attributs.

[in] dwAttrTypeAndAction

Ein -Wert, der eine bitweise Kombination der folgenden Flags darstellt. Der Aufrufer muss mindestens CRYPTCAT_ATTR_DATAASCII oder CRYPTCAT_ATTR_DATABASE64 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

Ein Zeiger auf eine CRYPTCATATTRIBUTE-Struktur , die das Katalogattribut 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

   
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