Funzione di callback SpQueryCredentialsAttributesFn (ntsecpkg.h)

Articolo
03/05/2024

La funzione SpQueryCredentialsAttributes recupera gli attributi per una credenziale.

La funzione SpQueryCredentialsAttributes è la funzione dispatch per la funzione QueryCredentialsAttributes dell'interfaccia del provider di supporto di sicurezza.

Sintassi

SpQueryCredentialsAttributesFn Spquerycredentialsattributesfn;

NTSTATUS Spquerycredentialsattributesfn(
  [in]  LSA_SEC_HANDLE CredentialHandle,
  [in]  ULONG CredentialAttribute,
  [out] PVOID Buffer
)
{...}

Parametri

[in] CredentialHandle

Handle per le credenziali da eseguire per la query.

[in] CredentialAttribute

Attributo da eseguire per la query. Nella tabella seguente sono elencati i valori validi.

Valore	Significato
SECPKG_CRED_ATTR_NAMES	Nome dell'entità associata alle credenziali.
SECPKG_ATTR_SUPPORTED_ALGS	Algoritmi supportati con credenziali specifiche.
SECPKG_ATTR_CIPHER_STRENGTHS	Livello minimo e massimo di crittografia usato con credenziali.
SECPKG_ATTR_SUPPORTED_PROTOCOLS	Protocolli supportati con credenziali specifiche.

[out] Buffer

Puntatore a un buffer che riceve gli attributi richiesti. Allocare memoria per questo buffer usando la funzione AllocateClientBuffer , in modo che il chiamante possa liberarlo chiamando la funzione FreeContextBuffer .

Valore restituito

Se la funzione ha esito positivo, restituire STATUS_SUCCESS.

Se la funzione ha esito negativo, restituire un codice NTSTATUS che indica il motivo per cui non è riuscito. Di seguito sono elencati i motivi comuni dell'errore e i codici di errore che la funzione deve restituire.

Codice restituito	Descrizione
SEC_E_INSUFFICIENT_MEMORY	L'allocazione di memoria ha avuto esito negativo.
SEC_E_INVALID_HANDLE	L'handle delle credenziali non è valido.

Commenti

SSP/APs deve implementare la funzione SpQueryCredentialsAttributes ; Tuttavia, il nome effettivo assegnato all'implementazione spetta allo sviluppatore.

Un puntatore alla funzione SpQueryCredentialsAttributes è disponibile nella struttura SECPKG_FUNCTION_TABLE ricevuta dalla funzione SpLsaModeInitialize .

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	ntsecpkg.h

Vedi anche

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize

Condividi tramite