SspiAcquireCredentialsHandleAsyncW 函式 (sspi.h)

SspiAcquireCredentialsHandleAsyncW函式會以非同步方式取得控制碼，以預先存在的安全性主體認證。

SspiInitializeSecurityCoNtextAsync和SspiAcceptSecurityCoNtextAsync函式需要此控制碼。 這些可以是預先存在的 認證，這些認證是透過此處未描述的系統登入所建立，或者呼叫端可以提供替代認證。

語法

SECURITY_STATUS SspiAcquireCredentialsHandleAsyncW(
  SspiAsyncContext *AsyncContext,
  PSECURITY_STRING pszPrincipal,
  PSECURITY_STRING pszPackage,
  unsigned long    fCredentialUse,
  void             *pvLogonId,
  void             *pAuthData,
  SEC_GET_KEY_FN   pGetKeyFn,
  void             *pvGetKeyArgument,
  PCredHandle      phCredential,
  PTimeStamp       ptsExpiry
);

參數

AsyncContext

非同步呼叫內容。

pszPrincipal

以 Null 結束之字串的指標，指定主體的名稱，該主體的認證會以非同步方式參考。

pszPackage

Null 終止字串的指標，指定將使用這些認證 的安全性套件 名稱。 這是EnumerateSecurityPackages函式所傳回的 SecPkgInfo結構Name成員中傳回的安全性套件名稱。 建立內容之後，可以使用ulAttribute設定為SECPKG_ATTR_PACKAGE_INFO呼叫QueryCoNtextAttributes (CredSSP) ，以傳回使用中安全性套件的相關資訊。

fCredentialUse

指出如何使用這些認證的旗標。 此參數可以是下列其中一個值：

pvLogonId

本機 唯一識別碼 的指標， (LUID) 識別使用者。 這個參數會提供給檔案系統進程，例如網路重新導向器。 此參數可以是 Null。

pAuthData

CREDSSP_CRED結構的指標，指定 Schannel 和 Negotiate 套件的驗證資料。

pGetKeyFn

GetKey () 函式的指標。

pvGetKeyArgument

傳遞至 GetKey () 。

phCredential

將接收認證控制碼的 CredHandle 結構的指標。

ptsExpiry

選TimeStamp結構的指標，可接收傳回認證到期的時間。 收到的結構值取決於安全性套件，這必須以當地時間指定值。

傳回值

如果取得認證控制碼的非同步要求已成功排入佇列以執行，則傳回 SEC_E_OK 。 否則，它會傳回嘗試將錯誤排入佇列時所產生的錯誤。 若要擷取作業的狀態，請使用 SspiGetAsyncCallStatus。

如果已取得控制碼，SspiGetAsyncCallStatus 會傳回 SEC_E_OK。 否則，如果呼叫仍在進行中，或下表中下列任何嚴重錯誤碼，它可能會傳回 SEC_I_ASYNC_CALL_PENDING 。

備註

SspiAcquireCredentialsHandleAsyncW函式會傳回主體的認證控制碼，例如使用者或用戶端，如特定安全性套件所使用的。 函式可以將控制碼傳回預先存在的認證或新建立的認證，並傳回它。 此控制碼可用於 SspiAcceptSecurityCoNtextAsync 和 SspiInitializeSecurityCoNtextAsync 函式的後續呼叫。

一般而言， SspiAcquireCredentialsHandleAsyncW 不會提供其他使用者登入相同電腦的認證。 不過，具有SE_TCB_NAME許可權的呼叫端可以藉由指定該會話的登入識別碼 (LUID) 來取得現有登入會話的認證。 一般而言，這是由必須代表登入使用者的核心模式模組使用。

封裝可能會在 RPC 執行時間傳輸所提供的 pGetKeyFn 中呼叫 函式。 如果傳輸不支援擷取認證的回呼概念，此參數必須是 Null。

對於核心模式呼叫者，必須注意下列差異：

• 這兩個字串參數必須是 Unicode 字串。
• 緩衝區值必須配置於進程虛擬記憶體中，而不是從集區配置。

當您完成使用傳回的認證時，請呼叫 SspiFreeCredentialsHandleAsync 函式來釋放認證所使用的記憶體。

規格需求

另請參閱

AcquireCredentialsHandle

SspiAcceptSecurityCoNtextAsync

SspiFreeCredentialsHandleAsync

SspiInitializeSecurityCoNtextAsync

SSPI 函式