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

  • Artículo

La función SpGetCredentials recupera las credenciales principales y complementarias del objeto de usuario.

Sintaxis

SpGetCredentialsFn Spgetcredentialsfn;

NTSTATUS Spgetcredentialsfn(
  [in]  LSA_SEC_HANDLE CredentialHandle,
  [out] PSecBuffer Credentials
)
{...}

Parámetros

[in] CredentialHandle

Identificador de las credenciales que se van a recuperar.

[out] Credentials

Puntero a una estructura SecBuffer que recibe las credenciales.

Valor devuelto

Si la función se ejecuta correctamente, devuelva STATUS_SUCCESS.

Si se produce un error en la función, devuelva un código NTSTATUS que indique el motivo por el que se produjo un error. A continuación se enumeran los motivos comunes de error y los códigos de error que debe devolver la función.

Código devuelto Descripción
SEC_E_INSUFFICIENT_MEMORY
 No hay memoria suficiente para recuperar las credenciales.
SEC_E_INVALID_HANDLE
 El identificador no es válido.

Comentarios

Los SSP/AP deben implementar la función SpGetCredentials ; sin embargo, el nombre real proporcionado a la implementación es para el desarrollador.

Hay disponible un puntero a la función SpGetCredentials en la estructura SECPKG_FUNCTION_TABLE recibida de la función SpLsaModeInitialize .

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

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize