Funzione SetCredentialsAttributesA (sspi.h)

Articolo
03/02/2024

Imposta gli attributi di una credenziale, ad esempio il nome associato alla credenziale. Le informazioni sono valide per qualsiasi contesto di sicurezza creato con le credenziali specificate.

Sintassi

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

Parametri

[in] phCredential

Handle delle credenziali da impostare.

[in] ulAttribute

Specifica l'attributo da impostare. Questo parametro può essere uno degli attributi seguenti.

Valore	Significato
SECPKG_CRED_ATTR_NAMES	Imposta il nome di una credenziale in un parametro pBuffer di tipo SecPkgCredentials_Names. Questo attributo non è supportato da Schannel in modalità WOW64.
SECPKG_CRED_ATTR_KDC_PROXY_SETTINGS	Imposta l'impostazione del proxy Kerberos in un parametro pBuffer di tipo SecPkgCredentials_KdcProxySettings. Questo attributo è supportato solo da Kerberos.
SECPKG_ATTR_SUPPORTED_ALGS	Imposta gli algoritmi supportati in un parametro pBuffer di tipo SecPkgCred_SupportedAlgs. Tutti gli algoritmi supportati sono inclusi, indipendentemente dal fatto che siano supportati dal certificato fornito o abilitati nel computer locale. Questo attributo è supportato solo da Schannel.
SECPKG_ATTR_CIPHER_STRENGTHS	Imposta i punti di forza della crittografia in un parametro pBuffer di tipo SecPkgCred_CipherStrengths. Questo attributo è supportato solo da Schannel.
SECPKG_ATTR_SUPPORTED_PROTOCOLS	Imposta gli algoritmi supportati in un parametro pBuffer di tipo SecPkgCred_SupportedProtocols. Tutti i protocolli supportati sono inclusi, indipendentemente dal fatto che siano supportati dal certificato fornito o abilitati nel computer locale. Questo attributo è supportato solo da Schannel.

[in] pBuffer

Puntatore a un buffer contenente il nuovo valore dell'attributo. Il tipo di struttura restituita dipende dal valore di ulAttribute.

cbBuffer

Dimensione, in byte, del buffer pBuffer .

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene SEC_E_OK.

Se la funzione ha esito negativo, il valore restituito può essere uno dei codici di errore seguenti.

Codice restituito	Descrizione
SEC_E_INVALID_HANDLE	L'handle passato alla funzione non è valido.
SEC_E_UNSUPPORTED_FUNCTION	L'attributo specificato non è supportato da Schannel. Questo valore restituito verrà restituito solo quando viene usato il provider di servizi condivisi Schannel.
SEC_E_INSUFFICIENT_MEMORY	Memoria insufficiente per completare la richiesta.

Commenti

Nota

L'intestazione sspi.h definisce SetCredentialsAttributes come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	sspi.h (include Security.h)
Libreria	Secur32.lib
DLL	Secur32.dll