Funzione di callback spQueryContextAttributesFn (ntsecpkg.h)
La funzione SpQueryContextAttributes recupera gli attributi di un contesto di sicurezza.
La funzione SpQueryContextAttributes è la funzione di invio per la funzione QueryContextAttributes (Generale)dell'interfaccia del provider di supporto della sicurezza.
Sintassi
SpQueryContextAttributesFn Spquerycontextattributesfn;
NTSTATUS Spquerycontextattributesfn(
[in] LSA_SEC_HANDLE ContextHandle,
[in] ULONG ContextAttribute,
[out] PVOID Buffer
)
{...}
Parametri
[in] ContextHandle
Handle al contesto di sicurezza.
[in] ContextAttribute
Attributo di contesto da eseguire in query. Per un elenco di valori validi, vedere la funzione QueryContextAttributes (Generale).
[out] Buffer
Puntatore che riceve l'indirizzo di un buffer contenente gli attributi richiesti. La memoria per il parametro Buffer deve essere allocata con la funzione AllocateHeap dalla tabella delle funzioni SECPKG_DLL_FUNCTIONS in modalità utente. In modalità LSA ( Local Security Authority ) usare la funzione AllocateLsaHeap .
Valore restituito
Se la funzione ha esito positivo, restituire STATUS_SUCCESS.
Se la funzione ha esito negativo, restituisce un codice NTSTATUS che indica il motivo per cui non è riuscito. Di seguito viene elencato un motivo comune per l'errore e il codice di errore restituito dalla funzione.
Codice restituito | Descrizione |
---|---|
|
L'handle non è valido. |
Commenti
SSP/APs deve implementare la funzione SpQueryContextAttributes ; tuttavia, il nome effettivo assegnato all'implementazione è fino allo sviluppatore.
Un puntatore all'implementazione in modalità LSA della funzione SpQueryContextAttributes è disponibile nella struttura SECPKG_FUNCTION_TABLEricevuta dalla funzione SpLsaModeInitialize .
Un puntatore all'implementazione in modalità utente della funzione SpQueryContextAttributes è disponibile nella struttura SECPKG_USER_FUNCTION_TABLE ricevuta dalla funzione SpUserModeInitialize .
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 |