Función de devolución de llamada CredReadFn (ntsecpkg.h)

  • Artículo

Lee una credencial del Administrador de credenciales.

Sintaxis

CredReadFn Credreadfn;

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

Parámetros

[in] LogonId

Identificador de inicio de sesión para el que se van a leer las credenciales.

[in] CredFlags

Marcas que determinan el comportamiento de esta función. Se definen las marcas siguientes.

Valor Significado
CREDP_FLAGS_IN_PROCESS
0x01
 El llamador está en proceso.
CREDP_FLAGS_USE_MIDL_HEAP
0x02
 El autor de la llamada debe usar la función midl_user_allocate para asignar el búfer de credenciales .
CREDP_FLAGS_DONT_CACHE_TI
0x04
 No almacene en caché la información de destino.
CREDP_FLAGS_CLEAR_PASSWORD
0x08
 Los datos de credenciales se pasan como texto no cifrado.
CREDP_FLAGS_USER_ENCRYPTED_PASSWORD
0x10
 Los datos de credenciales se cifran mediante la función RtlEncryptMemory .
CREDP_FLAGS_TRUSTED_CALLER
0x20
 El llamador es un proceso de confianza.

[in] TargetName

Nombre del equipo de destino.

[in] Type

Especifica el tipo de la credencial que se va a leer. Los valores posibles para este parámetro son los mismos que los valores posibles del miembro Type de la estructura CREDENTIAL .

[in] Flags

Reservado. Este parámetro debe establecerse en cero.

[out] Credential

Puntero a un puntero a una estructura de ENCRYPTED_CREDENTIALW que recibe las credenciales que lee esta función.

Valor devuelto

Si la función se ejecuta correctamente, devuelva STATUS_SUCCESS o un código de estado informativo.

Si se produce un error en la función, devuelva un código de error NTSTATUS que indique el motivo por el que se produjo un error.

Comentarios

Hay disponible un puntero a la función CrediRead en la estructura LSA_SECPKG_FUNCTION_TABLE recibida por la función SpInitialize .

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ntsecpkg.h

Consulte también

SpInitialize