CryptCATGetAttrInfo-Funktion (mscat.h)
[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.
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 |
|---|---|
|
Das Element oder das Attribut konnte nicht gefunden werden. |
|
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 |