AcceptSecurityCoNtext (General) 函式

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

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

語法

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 (General) 時，此指標為 NULL 。 在後續呼叫時， phCoNtext 是第一次呼叫在 phNewCoNtext 參數中傳回之部分格式內容的控制碼。

pInput[in, optional]

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

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

使用 Negotiate、Kerberos 或 NTLM SSP 時，除了呼叫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。

此參數不會搭配 Schannel 或摘要 SSP 使用。 當您使用 Schannel 或摘要 SSP 時，請為此參數指定零。

phNewCoNtext[in, out, optional]

CtxtHandle結構的指標。 在第一次呼叫 AcceptSecurityCoNtext (General) 時，這個指標會收到新的內容控制碼。 在後續呼叫時， 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 (General) 函式是InitializeSecurityCoNtext (General) 函式的伺服器對應專案。

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

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

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

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

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

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

規格需求

另請參閱

SSPI 函式

DeleteSecurityCoNtext

InitializeSecurityCoNtext (一般)