Funzione SetCredentialsAttributesA (sspi.h)

Articolo
11/20/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 è SEC_E_OK.

Se la funzione non riesce, 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.

Osservazioni

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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	sspi.h (include Security.h)
libreria	Secur32.lib
dll	Secur32.dll