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

  • Artículo

Se usa para agregar credenciales para una entidad de seguridad.

Sintaxis

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
)
{...}

Parámetros

[in] CredentialHandle

Identificador de la credencial que se va a agregar.

[in] PrincipalName

Opcional. Puntero a una estructura de UNICODE_STRING que contiene el nombre de la entidad de seguridad cuyas credenciales se van a agregar.

[in] Package

Puntero a una estructura de UNICODE_STRING que contiene el nombre del paquete de autenticación.

[in] CredentialUseFlags

Marcas que indican cómo se usarán las credenciales. Los valores siguientes son válidos.

Valor Significado
SECPKG_CRED_INBOUND
 Las credenciales se usarán con la función AcceptSecurityContext (General).
SECPKG_CRED_OUTBOUND
 Las credenciales se usarán con la función InitializeSecurityContext (General).

[in] AuthorizationData

Opcional. Puntero a datos de autenticación complementarios.

GetKeyFunciton

[in] GetKeyArgument

Puntero al argumento usado con la función GetKeyFunction .

[out] ExpirationTime

Puntero a timeStamp que recibe la hora en que expira el identificador de 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.

Comentarios

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

Hay disponible un puntero a la función SpAddCredentials en la estructura de 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