AcceptSecurityCoNtext (Schannel) 函式

AcceptSecurityCoNtext (Schannel) 函式可讓傳輸應用程式的伺服器元件在伺服器與遠端用戶端之間建立安全性內容。 遠端用戶端會使用 InitializeSecurityCoNtext (Schannel) 函式來啟動建立 安全性內容的程式。 伺服器可能需要來自遠端用戶端的一或多個回復權杖，才能完成 建立安全性內容。

語法

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     ptsTimeStamp
);

參數

phCredential[in, optional]

伺服器的認證控制碼。 伺服器會呼叫 AcquireCredentialsHandle (Schannel) 函式，並將SECPKG_CRED_INBOUND或SECPKG_CRED_BOTH旗標設定為擷取此控制碼。

phCoNtext[in, out, optional]

CtxtHandle結構的指標。 在第一次呼叫 AcceptSecurityCoNtext (Schannel) 時，此指標為 NULL 。 在後續呼叫時， phCoNtext 是第一次呼叫 在 phNewCoNtext 參數中傳回之部分形成內容的控制碼。

pInput[in, optional]

用戶端呼叫 InitializeSecurityCoNtext 所產生 之 SecBufferDesc 結構的指標 ， (Schannel) 包含輸入緩衝區描述元。

使用安全通道 安全性支援提供者 (SSP) 時，第一個緩衝區的類型必須為 SECBUFFER_TOKEN，且包含從用戶端接收的安全性權杖。 第二個緩衝區的類型應該是 SECBUFFER_EMPTY。

fCoNtextReq[in]

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

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

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

TargetDataRep[in]

此參數不會與安全通道搭配使用。 指定此參數的零。

phNewCoNtext[in, out, optional]

CtxtHandle結構的指標。 在第一次呼叫 AcceptSecurityCoNtext (Schannel) 時，此指標會收到新的內容控制碼。 在後續呼叫時， phNewCoNtext 可以與 phCoNtext 參數中指定的控制碼相同。 phNewCoNtext 不應該是 NULL 。

pOutput[in, out, optional]

SecBufferDesc結構的指標，其中包含輸出緩衝區描述項。 此緩衝區會傳送給用戶端，以輸入至 對 InitializeSecurityCoNtext (Schannel) 的其他呼叫。 即使函式傳回SEC_E_OK，也可能產生輸出緩衝區。 產生的任何緩衝區都必須傳回給用戶端應用程式。

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

pfCoNtextAttr[out]

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

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

ptsTimeStamp[out, optional]

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

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

傳回值

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

備註

AcceptSecurityCoNtext (Schannel) 函式是InitializeSecurityCoNtext (Schannel) 函式的伺服器對應專案。

當伺服器從用戶端收到要求時，伺服器會使用 fCoNtextReq 參數來指定會話所需的專案。 如此一來，伺服器就可以指定用戶端必須能夠使用機密或 完整性檢查的會話，而且可以拒絕不符合該需求的用戶端。 或者，伺服器不需要任何專案，而且任何用戶端都可以在 pfCoNtextAttr 參數中傳回或要求的任何專案。

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

1. 用戶端會將權杖傳送至伺服器。
2. 伺服器第一次呼叫 AcceptSecurityCoNtext (Schannel) ，這會產生接著傳送至用戶端的回復權杖。
3. 用戶端會接收權杖，並將其傳遞至 InitializeSecurityCoNtext (Schannel) 。 如果 InitializeSecurityCoNtext (Schannel) 傳回SEC_E_OK，則已完成相互驗證，而且可以開始安全會話。 如果 InitializeSecurityCoNtext (Schannel) 傳回錯誤碼，則相互驗證交涉會結束。 否則， InitializeSecurityCoNtext (Schannel) 傳回的安全性權杖會傳送至用戶端，並重複步驟 2 和 3。
4. 請勿在對AcceptSecurityCoNtext 的並行呼叫中使用 phCoNtext 值， (Schannel) 。 安全性提供者中的實作不是安全線程。

fCoNtextReq和pfCoNtextAttr參數是代表各種內容屬性的位元遮罩。 如需各種屬性的描述，請參閱 內容需求。

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

建立 安全性內容 之後，伺服器應用程式可以使用 QuerySecurityCoNtextToken 函式來擷取用戶端憑證所對應的使用者帳戶控制碼。 此外，伺服器可以使用 ImpersonateSecurityCoNtext 函式來模擬使用者。

規格需求

另請參閱

SSPI 函式

DeleteSecurityCoNtext

InitializeSecurityCoNtext (Schannel)