共用方式為

CryptCATPutAttrInfo 函式 (mscat.h)

  • 發行項

[ CryptCATPutAttrInfo 函式可用於需求一節中指定的作業系統。 後續版本可能會變更或無法使用。]

CryptCATPutAttrInfo 函式會配置屬性的記憶體，並將其新增至目錄成員。

語法

CRYPTCATATTRIBUTE * CryptCATPutAttrInfo(
  [in] HANDLE         hCatalog,
  [in] CRYPTCATMEMBER *pCatMember,
  [in] LPWSTR         pwszReferenceTag,
  [in] DWORD          dwAttrTypeAndAction,
  [in] DWORD          cbData,
  [in] BYTE           *pbData
);

參數

[in] hCatalog

從 CryptCATOpen 或 CryptCATHandleFromStore 函式取得之目錄的句柄。

[in] pCatMember

CRYPTCATMEMBER 結構的指標，其中包含目錄成員。

[in] pwszReferenceTag

包含屬性名稱之 Null 終止字串的指標。

[in] dwAttrTypeAndAction

值，表示下列旗標的位元組合。 呼叫端必須至少指定 CRYPTCAT_ATTR_DATABASE64 或 CRYPTCAT_ATTR_DATAASCII。

值 意義
CRYPTCAT_ATTR_AUTHENTICATED
0x10000000
 屬性已驗證。
CRYPTCAT_ATTR_UNAUTHENTICATED
0x20000000
 屬性未經驗證。
CRYPTCAT_ATTR_NAMEASCII
0x00000001
 屬性是 ASCII 字串。
CRYPTCAT_ATTR_NAMEOBJID
0x00000002
 屬性是 OID) (密碼編譯 物件標識碼 。
CRYPTCAT_ATTR_DATAASCII
0x00010000
 屬性包含不應譯碼的簡單 ASCII 字元。
CRYPTCAT_ATTR_DATABASE64
0x00020000
 屬性為base 64 格式。
CRYPTCAT_ATTR_DATAREPLACE
0x00040000
 屬性會取代現有屬性的值。

[in] cbData

值，指定 pbData 緩衝區中的位元元組數目。

[in] pbData

包含屬性值的記憶體緩衝區指標。

傳回值

成功時，此函式會傳回 CRYPTCATATTRIBUTE 結構的指標，其中包含指派的屬性。 呼叫端不得釋放此指標或其任何成員。

如果此函式傳回 NULL，則可以呼叫 GetLastError 函式來取得其他錯誤資訊。 GetLastError 會傳回下列其中一個錯誤碼。

傳回碼 Description
ERROR_INVALID_PARAMETER
 一或多個參數無效。
ERROR_NOT_ENOUGH_MEMORY
 操作系統在作業期間記憶體不足。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 mscat.h
程式庫 Wintrust.lib
Dll Wintrust.dll