Funzione di callback spAddCredentialsFn (ntsecpkg.h)

Articolo
03/13/2024

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
SECPKG_CRED_INBOUND	Le credenziali verranno usate con la funzione AcceptSecurityContext (Generale).
SECPKG_CRED_OUTBOUND	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_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