AcceptSecurityCoNtext (Kerberos) 函式

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

語法

SECURITY_STATUS SEC_Entry AcceptSecurityContext(
  _In_opt_    PCredHandle    phCredential,
  _In_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 (Kerberos) 函式，並將 SECPKG_CRED_INBOUND 或 SECPKG_CRED_BOTH 旗標設定為擷取此控制碼。

phCoNtext[in, out, optional]

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

pInput[in, optional]

用戶端呼叫InitializeSecurityCoNtext (Kerberos) 包含輸入緩衝區描述元的SecBufferDesc結構指標。

除了呼叫InitializeSecurityCoNtext (General) 函式所產生的緩衝區之外，還可以傳入類型為 SECBUFFER_CHANNEL_BINDINGS的SecBuffer結構，以指定通道系結資訊。 您可以藉由呼叫用戶端用來驗證之 Schannel 內容上的 QueryCoNtextAttributes (Schannel) 函式，來取得通道系結緩衝區的通道系結資訊。

fCoNtextReq[in]

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

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

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

TargetDataRep[in]

目標上的資料標記法，例如位元組順序。 此參數可以是SECURITY_NATIVE_DREP或SECURITY_NETWORK_DREP。

phNewCoNtext[in, out, optional]

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

pOutput[in, out, optional]

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

pfCoNtextAttr[out]

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

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

ptsTimeStamp[out, optional]

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

傳回值

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

備註

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

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

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

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

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

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

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

規格需求

另請參閱

SSPI 函式

DeleteSecurityCoNtext

InitializeSecurityCoNtext (Kerberos)