SetCredentialsAttributesA-Funktion (sspi.h)

Artikel
08/26/2023

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

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 eines der folgenden Attribute sein.

Wert	Bedeutung
SECPKG_CRED_ATTR_NAMES	Legt den Namen einer Anmeldeinformation in einem pBuffer-Parameter vom Typ SecPkgCredentials_Names fest. 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_KdcProxySettings fest. Dieses Attribut wird nur von Kerberos unterstützt.
SECPKG_ATTR_SUPPORTED_ALGS	Legt die unterstützten Algorithmen in einem pBuffer-Parameter vom Typ SecPkgCred_SupportedAlgs fest. 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 Verschlüsselungsstärken in einem pBuffer-Parameter vom Typ SecPkgCred_CipherStrengths fest. Dieses Attribut wird nur von Schannel unterstützt.
SECPKG_ATTR_SUPPORTED_PROTOCOLS	Legt die unterstützten Algorithmen in einem pBuffer-Parameter vom Typ SecPkgCred_SupportedProtocols fest. Alle unterstützten Protokolle 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.

[in] pBuffer

Ein Zeiger auf einen Puffer, der den neuen Attributwert enthält. Der Typ der zurückgegebenen Struktur hängt vom Wert von ulAttribute ab.

cbBuffer

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

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	Es ist nicht genügend Arbeitsspeicher verfügbar, um die Anforderung abzuschließen.

Hinweise

Hinweis

Der sspi.h-Header 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
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	sspi.h (einschließlich Security.h)
Bibliothek	Secur32.lib
DLL	Secur32.dll