CREDENTIAL_ATTRIBUTEA結構 (wincred.h)

CREDENTIAL_ATTRIBUTE結構包含認證的應用程式定義屬性。 屬性是關鍵字/值組。 應用程式必須定義 屬性的意義。

語法

typedef struct _CREDENTIAL_ATTRIBUTEA {
  LPSTR  Keyword;
  DWORD  Flags;
  DWORD  ValueSize;
  LPBYTE Value;
} CREDENTIAL_ATTRIBUTEA, *PCREDENTIAL_ATTRIBUTEA;

成員

Keyword

應用程式特定屬性的名稱。 名稱的格式應該是 < CompanyName > _ < Name > 。

此成員不能超過 CRED_MAX_STRING_LENGTH (256) 個字元。

Flags

識別認證屬性的特性。 這個成員是保留的，原本應該初始化為零，否則不會變更為允許未來的增強功能。

ValueSize

以位元組為單位的值長度。 此成員不能大於 CRED_MAX_VALUE_SIZE (256) 。

Value

與 屬性相關聯的資料。 根據慣例，如果 Value 是文字字串， 則 Value 不應包含尾端零字元，而且應該位於 UNICODE 中。

認證必須是可攜式的。 應用程式應該小心確保值中的資料可攜式。 應用程式必須負責在 Value中定義資料位元組端和對齊方式。

備註

注意

wincred.h 標頭會將CREDENTIAL_ATTRIBUTE定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
標頭	wincred.h