Funzione QueryCredentialsAttributesA (sspi.h)

Articolo
07/16/2024

Recupera 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 QueryCredentialsAttributesA(
  [in]  PCredHandle   phCredential,
  [in]  unsigned long ulAttribute,
  [out] void          *pBuffer
);

Parametri

[in] phCredential

Handle delle credenziali su cui eseguire query.

[in] ulAttribute

Specifica l'attributo da eseguire per la query. Questo parametro può essere uno degli attributi seguenti.

Valore	Significato
SECPKG_CRED_ATTR_CERT	Restituisce l'identificazione personale del certificato in un pbuffer di tipo SecPkgCredentials_Cert. Questo attributo è supportato solo da Kerberos. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo attributo non è disponibile.
SECPKG_CRED_ATTR_NAMES	Restituisce il nome di una credenziale in un pbuffer di tipo SecPkgCredentials_Names. Questo attributo non è supportato da Schannel in modalità WOW64.
SECPKG_ATTR_SUPPORTED_ALGS	Restituisce gli algoritmi supportati in un 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	Restituisce i punti di forza della crittografia in un pbuffer di tipo SecPkgCred_CipherStrengths. Questo attributo è supportato solo da Schannel.
SECPKG_ATTR_SUPPORTED_PROTOCOLS	Restituisce gli algoritmi supportati in un 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.

[out] pBuffer

Puntatore a un buffer che riceve l'attributo richiesto. Il tipo di struttura restituita dipende dal valore di ulAttribute.

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	La memoria disponibile non è sufficiente per completare la richiesta.

Osservazioni

La funzione QueryCredentialsAttributes consente a un'applicazione di determinare diverse caratteristiche di una credenziale, incluso il nome associato alle credenziali specificate.

L'esecuzione di query sull'attributo SECPKG_ATTR_CIPHER_STRENGTHS restituisce una struttura SecPkgCred_CipherStrengths. Il livello di crittografia in questa struttura è lo stesso della forza di crittografia nella struttura di SCH_CREDENTIALS utilizzata quando è stata creata una credenziale.

Nota Un'applicazione può trovare il livello di crittografia predefinito del sistema eseguendo una query su questo attributo con credenziali predefinite. Una credenziale predefinita viene creata chiamando acquireCredentialsHandle con un nullparametro pAuthData.

L'esecuzione di query sull'attributo SECPKG_ATTR_SUPPORTED_ALGS restituisce una struttura SecPkgCred_SupportedAlgs. Gli algoritmi in questa struttura sono compatibili con quelli indicati nella struttura SCH_CREDENTIALS utilizzata quando è stata creata una credenziale.

L'esecuzione di query sull'attributo SECPKG_ATTR_SUPPORTED_PROTOCOLS restituisce una struttura di SecPkgCred_SupportedProtocols che contiene una matrice di bit compatibile con il campo della struttura SCH_CREDENTIALS grbitEnabledProtocols.

Il chiamante deve allocare la struttura a cui punta il parametro pBuffer . Il pacchetto di sicurezza alloca il buffer per qualsiasi puntatore restituito nella struttura pBuffer. Il chiamante può chiamare la funzione FreeContextBuffer per liberare qualsiasi puntatore allocato dal pacchetto di sicurezza.

Nota

L'intestazione sspi.h definisce QueryCredentialsAttributes 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 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