Funzione di callback SpQueryCredentialsAttributesFn (ntsecpkg.h)

  • Articolo

La funzione SpQueryCredentialsAttributes recupera gli attributi per una credenziale.

La funzione SpQueryCredentialsAttributes è la funzione dispatch per la funzione QueryCredentialsAttributesdell'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_TABLEricevuta 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