Funzione di callback CredReadFn (ntsecpkg.h)

  • Articolo

Legge una credenziale da Credential Manager.

Sintassi

CredReadFn Credreadfn;

NTSTATUS Credreadfn(
  [in]  PLUID LogonId,
  [in]  ULONG CredFlags,
  [in]  LPWSTR TargetName,
  [in]  ULONG Type,
  [in]  ULONG Flags,
  [out] PENCRYPTED_CREDENTIALW *Credential
)
{...}

Parametri

[in] LogonId

ID di accesso per cui leggere le credenziali.

[in] CredFlags

Flag che determinano il comportamento di questa funzione. I flag seguenti sono definiti.

Valore Significato
CREDP_FLAGS_IN_PROCESS
0x01
 Il chiamante è in-process.
CREDP_FLAGS_USE_MIDL_HEAP
0x02
 Il chiamante deve usare la funzione midl_user_allocate per allocare il buffer delle credenziali .
CREDP_FLAGS_DONT_CACHE_TI
0x04
 Non memorizzare nella cache le informazioni di destinazione.
CREDP_FLAGS_CLEAR_PASSWORD
0x08
 I dati delle credenziali vengono passati come testo chiaro.
CREDP_FLAGS_USER_ENCRYPTED_PASSWORD
0x10
 I dati delle credenziali vengono crittografati usando la funzione RtlEncryptMemory .
CREDP_FLAGS_TRUSTED_CALLER
0x20
 Il chiamante è un processo attendibile.

[in] TargetName

Il nome del computer di destinazione.

[in] Type

Specifica il tipo delle credenziali da leggere. I valori possibili per questo parametro sono gli stessi valori possibili del membro Type della struttura CREDENTIAL .

[in] Flags

Riservato. Questo parametro deve essere impostato su zero.

[out] Credential

Puntatore a un puntatore a una struttura di ENCRYPTED_CREDENTIALW che riceve le credenziali lette da questa funzione.

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.

Commenti

Un puntatore alla funzione CrediRead è disponibile nella struttura LSA_SECPKG_FUNCTION_TABLE ricevuta dalla funzione SpInitialize .

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

SpInitialize