Funzione QueryCredentialsAttributesA (sspi.h)
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 una query.
[in] ulAttribute
Specifica l'attributo da eseguire per la query. Questo parametro può essere uno degli attributi seguenti.
Valore | Significato |
---|---|
|
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. |
|
Restituisce il nome di una credenziale in un pbuffer di tipo SecPkgCredentials_Names.
Questo attributo non è supportato da Schannel in modalità WOW64. |
|
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. |
|
Restituisce i punti di forza della crittografia in un pbuffer di tipo SecPkgCred_CipherStrengths.
Questo attributo è supportato solo da Schannel. |
|
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 viene SEC_E_OK.
Se la funzione ha esito negativo, il valore restituito può essere uno dei codici di errore seguenti.
Codice restituito | Descrizione |
---|---|
|
L'handle passato alla funzione non è valido. |
|
L'attributo specificato non è supportato da Schannel. Questo valore restituito verrà restituito solo quando viene usato il provider di servizi condivisi Schannel. |
|
La memoria disponibile non è sufficiente per completare la richiesta. |
Commenti
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 del livello di crittografia nella struttura SCH_CREDENTIALS utilizzata quando è stata creata una credenziale.
L'esecuzione di query sull'attributo SECPKG_ATTR_SUPPORTED_PROTOCOLS restituisce una struttura SecPkgCred_SupportedProtocols che contiene una matrice di bit compatibile con il campo grbitEnabledProtocols della struttura SCH_CREDENTIALS .
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 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 |
Vedi anche
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per