AcceptSecurityContext （一般） 函式

AcceptSecurityContext （一般） 函式可讓傳輸應用程式的伺服器元件在伺服器與遠端客戶端之間建立安全性內容。 遠端用戶端會使用 InitializeSecurityContext （一般） 函式來啟動建立 安全性內容的程式。 伺服器可能需要來自遠端用戶端的一或多個回復令牌，才能完成建立 安全性內容。

如需搭配特定 安全性支援提供者 使用此函式的相關信息，請參閱下列主題。

語法

SECURITY_STATUS SEC_Entry AcceptSecurityContext(
  _In_opt_    PCredHandle    phCredential,
  _Inout_opt_ PCtxtHandle    phContext,
  _In_opt_    PSecBufferDesc pInput,
  _In_        ULONG          fContextReq,
  _In_        ULONG          TargetDataRep,
  _Inout_opt_ PCtxtHandle    phNewContext,
  _Inout_opt_ PSecBufferDesc pOutput,
  _Out_       PULONG         pfContextAttr,
  _Out_opt_   PTimeStamp     ptsExpiry
);

參數

phCredential[in, optional]

伺服器的認證句柄。 伺服器會呼叫 AcquireCredentialsHandle （General） 函式，並將 SECPKG_CRED_INBOUND 或 SECPKG_CRED_BOTH 旗標設定為擷取此句柄。

phContext[in, out]

CtxtHandle 結構的指標。 在第一次呼叫 AcceptSecurityContext （一般）時，此指標為 NULL。 在後續的呼叫中，phContext 是第一次呼叫在 phNewContext 參數中傳回之部分格式內容的句柄。

pInput[in, optional]

由用戶端呼叫 InitializeSecurityContext （一般） 所產生之 SecBufferDesc 結構的指標，其中包含輸入緩衝區描述元。

使用 Schannel SSP 時，第一個緩衝區的類型必須為 SECBUFFER_TOKEN，且包含從用戶端接收的安全性令牌。 第二個緩衝區的類型應該是 SECBUFFER_EMPTY。

使用 Negotiate、Kerberos 或 NTLM SSP 時，除了呼叫 InitializeSecurityContext （General） 函式所產生的緩衝區之外，還可以藉由傳入類型為 SECBUFFER_CHANNEL_BINDINGS 的 SecBuffer 結構來指定通道系結資訊。 您可以在用戶端用來驗證的通道內容上呼叫 QueryContextAttributes （Schannel） 函式，以取得通道系結緩衝區的通道系結資訊。

fContextReq[in]

指定伺服器建立內容所需屬性的位旗標。 您可以使用位 OR 作業來合併位旗標。 此參數可以是下列其中一或多個值。

如需可能的屬性旗標及其意義，請參閱 內容需求。 用於此參數的旗標前面會加上ASC_REQ，例如ASC_REQ_DELEGATE。

用戶端可能不支援要求的屬性。 如需詳細資訊，請參閱 pfContextAttr 參數。

TargetDataRep[in]

目標上的數據表示法，例如位元組排序。 這個參數可以是SECURITY_NATIVE_DREP或SECURITY_NETWORK_DREP。

此參數不會與 Schannel 或 Digest SSP 搭配使用。 當您使用安全通道或摘要式 SSP 時，請為此參數指定零。

phNewContext[in, out, optional]

CtxtHandle 結構的指標。 在第一次呼叫 AcceptSecurityContext （一般）時，此指標會接收新的內容句柄。 在後續呼叫時，phNewContext 可以和 phContext 參數中指定的句柄相同。 phNewContext 不應該是 NULL。

pOutput[in, out, optional]

SecBufferDesc 結構的指標，其中包含輸出緩衝區描述元。 此緩衝區會傳送至用戶端，以輸入 至 InitializeSecurityContext （一般） 的其他呼叫。 即使函式傳回SEC_E_OK，仍可能會產生輸出緩衝區。 產生的任何緩衝區都必須傳送回用戶端應用程式。

使用安全通道時，在輸出中，此緩衝區會收到 安全性內容的令牌。 令牌必須傳送至用戶端。 函式也可以傳回類型為 SECBUFFER_EXTRA的緩衝區。 此外，呼叫端必須傳入類型 為 SECBUFFER_ALERT的緩衝區。 在輸出中，如果產生警示，此緩衝區會包含該警示的相關信息，且函式失敗。

pfContextAttr[out]

接收一組位旗標的變數指標，指出已建立內容的屬性。 如需各種屬性的描述，請參閱 內容需求。 用於此參數的旗標前面會加上 ASC_RET，例如ASC_RET_DELEGATE。

在最終函數調用成功傳回之前，請勿檢查安全性相關屬性。 屬性旗標與安全性無關，例如ASC_RET_ALLOCATED_MEMORY旗標，可以在最終傳回之前檢查。

ptsTimeStamp[out, optional]

TimeStamp 結構的指標，可接收內容的到期時間。 建議 安全性套件 一律以當地時間傳回此值。

此參數會設定為常數最大時間。 摘要式安全性內容或認證沒有到期時間，或使用摘要式 SSP 時。

使用安全通道 SSP 時，這是選擇性的。 當遠端合作物件提供要用於驗證的憑證時，此參數會收到該憑證的到期時間。 如果未提供憑證，則會傳回最大時間值。

返回值

此函式會傳回下列其中一個值。

備註

AcceptSecurityContext （一般） 函式是 InitializeSecurityContext （一般） 函式的伺服器對應專案。

當伺服器從用戶端接收要求時，伺服器會使用 fContextReq 參數來指定會話所需的專案。 以這種方式，伺服器可以指定客戶端必須能夠使用機密或 完整性檢查的會話，而且它可以拒絕不符合該需求的用戶端。 或者，伺服器不需要任何專案，而且用戶端可以在 pfContextAttr 參數中傳回或要求的任何專案。

對於支援多回合驗證的套件，例如相互驗證，呼叫順序如下所示：

1. 用戶端會將令牌傳送至伺服器。
2. 伺服器第一次呼叫 AcceptSecurityContext （一般） ，這會產生回復令牌，然後傳送至用戶端。
3. 用戶端會收到令牌，並將它傳遞至 InitializeSecurityContext （一般） 。 如果 InitializeSecurityContext （一般） 傳回SEC_E_OK，則相互驗證已完成，且安全會話可以開始。 如果 InitializeSecurityContext （一般） 傳回錯誤碼，相互驗證交涉就會結束。 否則， InitializeSecurityContext 傳 回的安全性令牌會傳送至用戶端，並重複步驟 2 和 3。
4. 請勿在 AcceptSecurityContext （一般） 的並行呼叫中使用 phContext 值。 安全性提供者中的實作不是安全線程。

fContextReq 和 pfContextAttr 參數是代表各種內容屬性的位掩碼。 如需各種屬性的描述，請參閱 內容需求。

呼叫端負責判斷最終內容屬性是否足夠。 例如，如果要求機密性（加密），但無法建立，某些應用程式可能會選擇立即關閉連線。 如果無法建立安全性內容，伺服器必須藉由呼叫DeleteSecurityContext函式釋放部分建立的內容。 如需何時呼叫 DeleteSecurityContext 函式的相關信息，請參閱 DeleteSecurityContext。

建立 安全性內容 之後，伺服器應用程式可以使用 QuerySecurityContextToken 函式來擷取客戶端憑證所對應的用戶帳戶句柄。 此外，伺服器可以使用 ImpersonateSecurityContext 函式來模擬使用者。

需求

另請參閱

SSPI 函式

DeleteSecurityContext

InitializeSecurityContext （一般）