Funzione di callback SpUpdateCredentialsFn (ntsecpkg.h)

Articolo
02/29/2024

Aggiornamenti le credenziali associate al contesto specificato.

Sintassi

SpUpdateCredentialsFn Spupdatecredentialsfn;

NTSTATUS Spupdatecredentialsfn(
  [in] LSA_SEC_HANDLE ContextHandle,
  [in] GUID *CredType,
  [in] ULONG FlatCredUIContextLength,
       PUCHAR FlatCredUIContext
)
{...}

Parametri

[in] ContextHandle

Handle per il contesto da aggiornare.

[in] CredType

Tipo di credenziale specificato dal parametro ContextHandle . Può trattarsi di uno dei valori seguenti.

Valore	Significato
SEC_WINNT_AUTH_DATA_TYPE_PASSWORD 0x28bfc32f, 0x10f6, 0x4738, 0x98, 0xd1, 0x1a, 0xc0, 0x61, 0xdf, 0x71, 0x6a	Le credenziali sono una password.
SEC_WINNT_AUTH_DATA_TYPE_CERT 0x235f69ad, 0x73fb, 0x4dbc, 0x82, 0x3, 0x6, 0x29, 0xe7, 0x39, 0x33, 0x9b	Le credenziali sono un certificato.
SEC_WINNT_AUTH_DATA_TYPE_CSP_DATA 0x68fd9879, 0x79c, 0x4dfe, 0x82, 0x81, 0x57, 0x8a, 0xad, 0xc1, 0xc1, 0x0	Le credenziali sono dati di autenticazione da un provider di servizi di crittografia (CSP).

[in] FlatCredUIContextLength

Dimensione, in caratteri, del buffer specificato dal parametro FlatCredUIContext .

FlatCredUIContext

Stringa che specifica le credenziali aggiornate.

Valore restituito

Se la funzione ha esito positivo, restituire STATUS_SUCCESS o un codice di stato informativo.

Se la funzione ha esito negativo, restituisce un codice di errore NTSTATUS che indica il motivo per cui non è riuscito. Per altre informazioni, vedere la sezione Osservazioni.

Commenti

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ntsecpkg.h