Funzione di callback spAddCredentialsFn (ntsecpkg.h)
Usato per aggiungere credenziali per un'entità di sicurezza.
Sintassi
SpAddCredentialsFn Spaddcredentialsfn;
NTSTATUS Spaddcredentialsfn(
[in] LSA_SEC_HANDLE CredentialHandle,
[in] PUNICODE_STRING PrincipalName,
[in] PUNICODE_STRING Package,
[in] ULONG CredentialUseFlags,
[in] PVOID AuthorizationData,
PVOID GetKeyFunciton,
[in] PVOID GetKeyArgument,
[out] PTimeStamp ExpirationTime
)
{...}
Parametri
[in] CredentialHandle
Handle alla credenziale da aggiungere.
[in] PrincipalName
facoltativo. Puntatore a una struttura UNICODE_STRING contenente il nome dell'entità di sicurezza le cui credenziali vengono aggiunte.
[in] Package
Puntatore a una struttura UNICODE_STRING contenente il nome del pacchetto di autenticazione.
[in] CredentialUseFlags
Flag che indicano come verranno usate le credenziali. I valori seguenti sono validi.
Valore | Significato |
---|---|
|
Le credenziali verranno usate con la funzione AcceptSecurityContext (Generale). |
|
Le credenziali verranno usate con la funzione InitializeSecurityContext (Generale). |
[in] AuthorizationData
facoltativo. Puntatore ai dati di autenticazione supplementari.
GetKeyFunciton
[in] GetKeyArgument
Puntatore all'argomento usato con la funzione GetKeyFunction .
[out] ExpirationTime
Puntatore a un TimeStamp che riceve l'ora di scadenza dell'handle delle credenziali.
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.
Commenti
SSP/AP deve implementare la funzione SpAddCredentials ; tuttavia, il nome effettivo assegnato all'implementazione è fino allo sviluppatore.
Un puntatore alla funzione SpAddCredentials è 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 |