共用方式為

CredPackAuthenticationBufferA 函式 （wincred.h）

  • 發行項

CredPackAuthenticationBuffer 函式會將字串使用者名稱和密碼轉換成驗證緩衝區。

從 Windows 8 和 Windows Server 2012 開始，CredPackAuthenticationBuffer 函式會將身分識別認證轉換成驗證緩衝區，這是 SEC_WINNT_AUTH_IDENTITY_EX2 結構。 此緩衝區可以傳遞至 LsaLogonUser、AcquireCredentialsHandle或其他識別提供者介面。

語法

CREDUIAPI BOOL CredPackAuthenticationBufferA(
  [in]      DWORD dwFlags,
  [in]      LPSTR pszUserName,
  [in]      LPSTR pszPassword,
  [out]     PBYTE pPackedCredentials,
  [in, out] DWORD *pcbPackedCredentials
);

參數

[in] dwFlags

指定應該如何封裝認證。 這可以是下列旗標的組合。

價值 意義
CRED_PACK_PROTECTED_CREDENTIALS
 加密認證，使其只能由呼叫端登入會話中的進程解密。
CRED_PACK_WOW_BUFFER
 加密 WOW 緩衝區中的認證。
CRED_PACK_GENERIC_CREDENTIALS
 加密CRED_GENERIC緩衝區中的認證。
CRED_PACK_ID_PROVIDER_CREDENTIALS
 將在線身分識別的認證加密為 SEC_WINNT_AUTH_IDENTITY_EX2 結構。 如果未設定CRED_PACK_GENERIC_CREDENTIALS和CRED_PACK_ID_PROVIDER_CREDENTIALS，則會加密KERB_INTERACTIVE_LOGON緩衝區中的認證。

Windows 7、Windows Server 2008 R2、Windows Vista、Windows Server 2008：不支援此值。

[in] pszUserName

Null 終止字串的指標，指定要轉換的用戶名稱。 針對網域使用者，字串的格式必須如下：

DomainName\UserName

針對在線身分識別，如果認證是純文字密碼，則使用者名稱格式會 ProviderName\UserName。 如果認證是 SEC_WINNT_AUTH_IDENTITY_EX2 結構，則使用者名稱是編碼字串，這是函式呼叫 SspiEncodeAuthIdentityAsStringsUserName 參數輸出。

針對 智慧卡 或憑證認證，用戶名稱是編碼字元串，這是使用 CertCredential 選項對 CredMarshalCredential 函數調用的輸出。

Windows Server 2008 R2、Windows 7、Windows Server 2008 和 Windows Vista：不支援 Online 身分識別。

[in] pszPassword

Null 終止字串的指標，指定要轉換的密碼。

針對 SEC_WINNT_AUTH_IDENTITY_EX2 認證，密碼是 ppszPackedCredentialsString 中的編碼字串， 函式呼叫的輸出 SspiEncodeAuthIdentityAsStrings。

對於 智慧卡 認證，這是 智慧卡 PIN。

Windows Server 2008 R2、Windows 7、Windows Server 2008 和 Windows Vista：不支援 Online 身分識別。

[out] pPackedCredentials

輸出時，位元組陣列的指標會接收已封裝的驗證緩衝區。 這個參數可以 NULL，以在 參數中接收所需的緩衝區大小。

[in, out] pcbPackedCredentials

DWORD 值的指標，指定 pPackedCredentials 緩衝區的大小，以位元組為單位。 在輸出中，如果緩衝區大小不足，請指定 pPackedCredentials 緩衝區所需的大小，以位元組為單位。

傳回值

如果函式成功，TRUE;否則，FALSE。

如需擴充的錯誤資訊，請呼叫 getLastError 函式 ，這可能會傳回下列錯誤碼。

傳回碼 描述
ERROR_INSUFFICIENT_BUFFER
 pPackedCredentials 所提供的緩衝區太小。

言論

注意

wincred.h 標頭會根據 UNICODE 預處理器常數的定義，將 CredPackAuthenticationBuffer 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 wincred.h
連結庫 Credui.lib
DLL Credui.dll