共用方式為

SpExchangeMetaDataFn 回呼函式 (ntsecpkg.h)

  • 發行項

將元數據傳送至 安全性支援提供者。 此函式所傳送的元數據是由 先前呼叫 SpQueryMetaDataFn 函式所取得。

語法

SpExchangeMetaDataFn Spexchangemetadatafn;

NTSTATUS Spexchangemetadatafn(
  [in]           LSA_SEC_HANDLE CredentialHandle,
  [in, optional] PUNICODE_STRING TargetName,
  [in]           ULONG ContextRequirements,
  [in]           ULONG MetaDataLength,
  [in]           PUCHAR MetaData,
  [in, out]      PLSA_SEC_HANDLE ContextHandle
)
{...}

參數

[in] CredentialHandle

要用於安全性內容的認證句柄。 如果 ContextHandle 參數指向輸入上的 NULL ，此函式會使用此參數的值來建立安全性內容。

如果 ContextHandle 參數指向輸入上的 NULL，則這個參數的值不能是 NULL。

[in, optional] TargetName

包含內容目標名稱 的UNICODE_STRING 指標。

[in] ContextRequirements

指出用戶端所需內容屬性的旗標。

以下是有效的值。 您可以使用邏輯 OR 作業來合併值。

值 意義
ISC_REQ_DELEGATE
 允許伺服器模擬用戶端。
ISC_REQ_MUTUAL_AUTH
 用戶端和伺服器都需要證明其身分識別。
ISC_REQ_REPLAY_DETECT
 安全性內容將支持偵測重新執行的封包。
ISC_REQ_SEQUENCE_DETECT
 安全性內容將支援偵測順序錯誤訊息。
ISC_REQ_USE_SESSION_KEY
 必須交涉新的 會話金鑰 。
ISC_REQ_PROMPT_FOR_CREDS
 如果用戶端是互動式使用者，封裝必須盡可能提示使用者輸入適當的認證。
ISC_REQ_USE_SUPPLIED_CREDS
 輸入緩衝區包含封裝特定的認證資訊，應該用來驗證連線。
ISC_REQ_ALLOCATE_MEMORY
 封裝必須配置記憶體。 呼叫端最終必須呼叫 FreeContextBuffer函 式，以釋放封裝所配置的記憶體。
ISC_REQ_USE_DCE_STYLE
 呼叫端需要三次相互驗證交易。
ISC_REQ_DATAGRAM
 應該使用數據報類型通道。 如需詳細資訊，請參閱 數據報內容。
ISC_REQ_CONNECTION
 應該使用連線類型通道。 如需詳細資訊，請參閱 連接導向內容。
ISC_REQ_EXTENDED_ERROR
 如果內容失敗，請產生錯誤回復訊息以傳送回用戶端。
ISC_REQ_STREAM
 應該使用串流類型通道。 如需詳細資訊，請參閱 Stream 內容。
ISC_REQ_INTEGRITY
 已驗證緩衝區完整性;不過，不會偵測到重新執行和序列外訊息。

[in] MetaDataLength

MetaData 緩衝區的大小，以字元為單位。

[in] MetaData

要傳送的元數據。

[in, out] ContextHandle

要使用的安全性句柄句柄。 如果此參數指向輸入上的 NULL ，此函式會使用 CredentialHandle 和 TargetName 參數的值來配置和初始化安全性內容。

如果此參數指向輸入上的 NULL，CredentialHandle 不能是 NULL。

傳回值

如果函式成功，請傳回 STATUS_SUCCESS或參考狀態代碼。

如果函式失敗，請傳回 NTSTATUS 錯誤碼，指出失敗的原因。 如需詳細資訊，請參閱＜備註＞。

備註

SpExchangeMetaDataFn 函式的指標可在從 SpLsaModeInitialize 函式收到的SECPKG_FUNCTION_TABLE結構中使用。

規格需求

需求 值
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限桌面應用程式]
目標平台 Windows
標頭 ntsecpkg.h