Función CredGetSessionTypes (wincred.h)

  • Artículo

La función CredGetSessionTypes devuelve la persistencia máxima admitida por la sesión de inicio de sesión actual. Se devuelve una persistencia máxima independiente para cada tipo de credencial.

Sintaxis

BOOL CredGetSessionTypes(
  [in]  DWORD   MaximumPersistCount,
  [out] LPDWORD MaximumPersist
);

Parámetros

[in] MaximumPersistCount

Número de elementos de la matriz MaximumPersist . Use CRED_TYPE_MAXIMUM para devolver todos los tipos de credenciales definidos actualmente.

[out] MaximumPersist

Puntero a una matriz en la que se devuelven los valores de persistencia. La matriz pasada debe ser elementos MaximumPersistCount long. A la devolución, cada elemento especifica la persistencia máxima admitida por el tipo de credencial correspondiente.

El autor de la llamada debe usar uno de los siguientes define para indexar en la matriz:

  • CRED_TYPE_GENERIC
  • CRED_TYPE_DOMAIN_PASSWORD
  • CRED_TYPE_DOMAIN_CERTIFICATE
Es decir, MaximumPersist[CRED_TYPE_GENERIC] especifica la persistencia máxima admitida para las credenciales genéricas.

Los valores siguientes se pueden devolver en cada elemento de la matriz.

Valor Significado
CRED_PERSIST_NONE
 No se puede almacenar ninguna credencial. Este valor se devolverá si la directiva no admite el tipo de credencial o si la directiva no lo ha deshabilitado.
CRED_PERSIST_SESSION
 Solo se puede almacenar una credencial específica de la sesión.
CRED_PERSIST_LOCAL_MACHINE
 Las credenciales específicas de la sesión y específicas del equipo se pueden almacenar.

Windows XP: Esta credencial no se puede almacenar para las sesiones en las que no se carga el perfil.
CRED_PERSIST_ENTERPRISE
 Se puede almacenar cualquier credencial.

Windows XP: Esta credencial no se puede almacenar para las sesiones en las que no se carga el perfil.

Valor devuelto

Esta función devuelve TRUE si se ejecuta correctamente y FALSE en caso de error. Se puede llamar a la función GetLastError para obtener un código de estado más específico. Se puede devolver el código de estado siguiente:

ERROR_NO_SUCH_LOGON_SESSION

La sesión de inicio de sesión no existe o no hay ningún conjunto de credenciales asociado a esta sesión de inicio de sesión. Las sesiones de inicio de sesión de red no tienen un conjunto de credenciales asociado.

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 wincred.h
Library Advapi32.lib
Archivo DLL Advapi32.dll