Поделиться через

структура CREDENTIAL_ATTRIBUTEW (wincred.h)

  • Статья

Структура CREDENTIAL_ATTRIBUTE содержит определяемый приложением атрибут учетных данных. Атрибут — это пара "ключевое слово-значение". Это до приложения, чтобы определить значение атрибута.

Синтаксис

typedef struct _CREDENTIAL_ATTRIBUTEW {
#if ...
  wchar_t *Keyword;
#else
  LPWSTR  Keyword;
#endif
  DWORD   Flags;
  DWORD   ValueSize;
  LPBYTE  Value;
} CREDENTIAL_ATTRIBUTEW, *PCREDENTIAL_ATTRIBUTEW;

Члены

Keyword

Имя атрибута для конкретного приложения. Имена должны иметь форму <CompanyName>_<Name>.

Этот член не может превышать CRED_MAX_STRING_LENGTH (256) символов.

Flags

Определяет характеристики атрибута учетных данных. Этот элемент зарезервирован и изначально должен быть инициализирован как нулевой, а не изменен, чтобы разрешить дальнейшее улучшение.

ValueSize

Длина значения в байтах. Этот элемент не может быть больше CRED_MAX_VALUE_SIZE (256).

Value

Данные, связанные с атрибутом. По соглашению, если значение является текстовой строкой, значение не должно содержать конечный нулевой знак и должен находиться в ЮНИКОДе.

Ожидается, что учетные данные будут переносимыми. Приложение должно заботиться о том, чтобы данные в значении переносятся. Приложение отвечает за определение байтов и выравнивание данных в value.

Замечания

Заметка

Заголовок wincred.h определяет CREDENTIAL_ATTRIBUTE как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows XP [только классические приложения]
минимальный поддерживаемый сервер Windows Server 2003 [только классические приложения]
заголовка wincred.h