CryptCATPutAttrInfo-Funktion (mscat.h)

[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.

[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.

Anforderungen