TokenBindingGenerateMessage 函式 (tokenbinding.h)

組合權杖系結清單,並將用戶端裝置的最終訊息產生至伺服器。

語法

SECURITY_STATUS TokenBindingGenerateMessage(
  [in]  const void * [] tokenBindings,
  [in]  const DWORD []  tokenBindingsSize,
  [in]  DWORD           tokenBindingsCount,
  [out] void            **tokenBindingMessage,
  [out] DWORD           *tokenBindingMessageSize
);

參數

[in] tokenBindings

權杖系結結構的陣列指標。

[in] tokenBindingsSize

陣列,包含 tokenBindings 參數中陣列包含之對應權杖系結結構的大小,以位元組為單位。

[in] tokenBindingsCount

tokenBindings參數中陣列包含的專案數目。 這個值不能是 0。

[out] tokenBindingMessage

接收配置給權杖系結訊息之緩衝區位址的指標。 使用 HeapAlloc 函式來配置此緩衝區的記憶體,並使用 HeapFree 方法來釋放該記憶體。

[out] tokenBindingMessageSize

變數的指標,其中包含為 tokenBindingMessage 參數配置的緩衝區大小。

傳回值

傳回狀態碼,指出函式的成功或失敗。

備註

您可以從使用者模式呼叫 TokenBindingGenerateMessage

規格需求

   
最低支援的用戶端 Windows 10 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2016 [僅限傳統型應用程式]
目標平臺 Windows
標頭 tokenbinding.h
程式庫 Tokenbinding.lib
DLL Tokenbinding.dll

另請參閱

HeapAlloc

HeapFree

TokenBindingVerifyMessage