Функция CredGetSessionTypes (wincred.h)

  • Статья

Функция CredGetSessionTypes возвращает максимальное значение сохраняемости, поддерживаемого текущим сеансом входа. Для каждого типа учетных данных возвращается отдельная максимальная сохраняемость.

Синтаксис

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

Параметры

[in] MaximumPersistCount

Количество элементов в массиве MaximumPersist . Используйте CRED_TYPE_MAXIMUM для возврата всех текущих типов учетных данных.

[out] MaximumPersist

Указатель на массив для возврата значений сохраняемости. Переданный массив должен иметь длину элементов MaximumPersistCount . При возврате каждый элемент задает максимальное значение сохраняемости, поддерживаемого соответствующим типом учетных данных.

Вызывающий объект должен использовать одно из следующих определений для индексирования в массиве:

  • CRED_TYPE_GENERIC
  • CRED_TYPE_DOMAIN_PASSWORD
  • CRED_TYPE_DOMAIN_CERTIFICATE
То есть MaximumPersist[CRED_TYPE_GENERIC] задает максимальное значение сохраняемости, поддерживаемого для универсальных учетных данных.

Следующие значения могут быть возвращены в каждом элементе массива.

Значение Значение
CRED_PERSIST_NONE
 Учетные данные не могут храниться. Это значение будет возвращено, если тип учетных данных не поддерживается или отключен политикой.
CRED_PERSIST_SESSION
 Могут храниться только учетные данные для конкретного сеанса.
CRED_PERSIST_LOCAL_MACHINE
 Можно хранить учетные данные для конкретного сеанса и компьютера.

Windows XP: Эти учетные данные не могут храниться для сеансов, в которых не загружается профиль.
CRED_PERSIST_ENTERPRISE
 Можно сохранить любые учетные данные.

Windows XP: Эти учетные данные не могут храниться для сеансов, в которых не загружается профиль.

Возвращаемое значение

Эта функция возвращает значение TRUE при успешном выполнении и FALSE при сбое. Для получения более конкретного кода состояния можно вызвать функцию GetLastError . Можно вернуть следующий код состояния:

ERROR_NO_SUCH_LOGON_SESSION

Сеанс входа не существует или с этим сеансом входа не связан набор учетных данных. Сеансы сетевого входа не имеют связанных учетных данных.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header wincred.h
Библиотека Advapi32.lib
DLL Advapi32.dll