SetCredentialsAttributesA-Funktion (sspi.h)

Artikel
11/20/2024

Legt die Attribute einer Anmeldeinformationfest, z. B. den Namen, der den Anmeldeinformationen zugeordnet ist. Die Informationen sind für jeden Sicherheitskontext gültig, mit den angegebenen Anmeldeinformationen erstellt wurden.

Syntax

SECURITY_STATUS SEC_ENTRY SetCredentialsAttributesA(
  [in] PCredHandle   phCredential,
  [in] unsigned long ulAttribute,
  [in] void          *pBuffer,
       unsigned long cbBuffer
);

Parameter

[in] phCredential

Ein Handle der festzulegenden Anmeldeinformationen.

[in] ulAttribute

Gibt das festzulegende attribut an. Dieser Parameter kann ein beliebiges der folgenden Attribute sein.

Wert	Bedeutung
SECPKG_CRED_ATTR_NAMES	Legt den Namen einer Anmeldeinformation in einem pBuffer Parameter vom Typ SecPkgCredentials_Namesfest. Dieses Attribut wird von Schannel im WOW64-Modus nicht unterstützt.
SECPKG_CRED_ATTR_KDC_PROXY_SETTINGS	Legt die Kerberos-Proxyeinstellung in einem pBuffer Parameter vom Typ SecPkgCredentials_KdcProxySettingsfest. Dieses Attribut wird nur von Kerberos unterstützt.
SECPKG_ATTR_SUPPORTED_ALGS	Legt die unterstützten Algorithmen in einem pBuffer Parameter vom Typ SecPkgCred_SupportedAlgsfest. Alle unterstützten Algorithmen sind enthalten, unabhängig davon, ob sie vom bereitgestellten Zertifikat unterstützt oder auf dem lokalen Computer aktiviert sind. Dieses Attribut wird nur von Schannel unterstützt.
SECPKG_ATTR_CIPHER_STRENGTHS	Legt die Chiffrestärken in einem pBuffer Parameter vom Typ SecPkgCred_CipherStrengthsfest. Dieses Attribut wird nur von Schannel unterstützt.
SECPKG_ATTR_SUPPORTED_PROTOCOLS	Legt die unterstützten Algorithmen in einem pBuffer Parameter vom Typ SecPkgCred_SupportedProtocolsfest. Alle unterstützten Protokolle sind enthalten, unabhängig davon, ob sie vom bereitgestellten Zertifikat unterstützt oder auf dem lokalen Computer aktiviert werden. Dieses Attribut wird nur von Schannel unterstützt.

[in] pBuffer

Ein Zeiger auf einen Puffer, der den neuen Attributwert enthält. Der typ der zurückgegebenen Struktur hängt vom Wert ulAttributeab.

cbBuffer

Die Größe des pBuffer- Puffers in Byte.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert SEC_E_OK.

Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Fehlercodes sein.

Rückgabecode	Beschreibung
SEC_E_INVALID_HANDLE	Das an die Funktion übergebene Handle ist ungültig.
SEC_E_UNSUPPORTED_FUNCTION	Das angegebene Attribut wird von Schannel nicht unterstützt. Dieser Rückgabewert wird nur zurückgegeben, wenn der Schannel-SSP verwendet wird.
SEC_E_INSUFFICIENT_MEMORY	Nicht genügend Arbeitsspeicher ist verfügbar, um die Anforderung abzuschließen.

Bemerkungen

Anmerkung

Der Header "sspi.h" definiert SetCredentialsAttributes als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	sspi.h (include Security.h)
Library	Secur32.lib
DLL-	Secur32.dll