CryptCATGetAttrInfo-Funktion (mscat.h)

  • Artikel

[Die CryptCATGetAttrInfo-Funktion steht für die Verwendung in den Betriebssystemen zur Verfügung, die im Abschnitt Anforderungen angegeben sind. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Die CryptCATGetAttrInfo-Funktion ruft Informationen zu einem Attribut eines Members eines Katalogs ab.

Syntax

CRYPTCATATTRIBUTE * CryptCATGetAttrInfo(
  [in] HANDLE         hCatalog,
  [in] CRYPTCATMEMBER *pCatMember,
  [in] LPWSTR         pwszReferenceTag
);

Parameter

[in] hCatalog

Das Handle des Katalogs, der das Element enthält, für das die Attributinformationen abgerufen werden sollen. Dieses Handle wird durch Aufrufen der CryptCATOpen-Funktion abgerufen. Dieser Parameter ist erforderlich und darf nicht NULL sein.

[in] pCatMember

Ein Zeiger auf eine CRYPTCATMEMBER-Struktur , die das Element darstellt, für das die Attributinformationen abgerufen werden sollen. Dies kann durch Aufrufen der CryptCATGetMemberInfo-Funktion abgerufen werden. Dieser Parameter ist erforderlich und darf nicht NULL sein.

[in] pwszReferenceTag

Ein Zeiger auf eine Unicode-Zeichenfolge mit Null-Beendigung, die den Namen des Attributs enthält, für das die Informationen abgerufen werden sollen. Dieser Parameter ist erforderlich und darf nicht NULL sein.

Rückgabewert

Diese Funktion gibt einen Zeiger auf eine CRYPTCATATTRIBUTE-Struktur zurück, die die Attributinformationen enthält. Wenn bei der Funktion ein Fehler auftritt, gibt sie NULL zurück.

Wichtig Geben Sie weder den zurückgegebenen Zeiger noch einen der Elemente frei, auf die der zurückgegebene Zeiger verweist.
 

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

Rückgabecode Beschreibung
CRYPT_E_NOT_FOUND
 Das Element oder das Attribut konnte nicht gefunden werden.
ERROR_INVALID_PARAMETER
 Mindestens ein Parameter ist ungültig.

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

Weitere Informationen

CRYPTCATATTRIBUTE

CRYPTCATMEMBER

CryptCATGetMemberInfo

CryptCATOpen