AcquireCredentialsHandleA 関数 (sspi.h)
構文
SECURITY_STATUS SEC_ENTRY AcquireCredentialsHandleA(
[in, optional] LPSTR pszPrincipal,
[in] LPSTR pszPackage,
[in] unsigned long fCredentialUse,
[in, optional] void *pvLogonId,
[in, optional] void *pAuthData,
[in, optional] SEC_GET_KEY_FN pGetKeyFn,
[in, optional] void *pvGetKeyArgument,
[out] PCredHandle phCredential,
[out, optional] PTimeStamp ptsExpiry
);
パラメーター
[in, optional] pszPrincipal
ハンドルが参照する資格情報を持つプリンシパルの名前を指定する null で終わる文字列へのポインター。
[in] pszPackage
これらの資格情報を使用する
[in] fCredentialUse
これらの資格情報の使用方法を示すフラグ。 このパラメーターには、次のいずれかの値を指定できます。
[in, optional] pvLogonId
ユーザーを識別する ローカル一意識別子 (LUID) へのポインター。 このパラメーターは、ネットワーク リダイレクターなどのファイル システム プロセスに対して提供されます。 このパラメーターは NULL
[in, optional] pAuthData
Schannel パッケージと Negotiate パッケージの両方の認証データを指定する CREDSSP_CRED 構造体へのポインター。
[in, optional] pGetKeyFn
引っ込み思案。 このパラメーターは使用されず、NULLを
[in, optional] pvGetKeyArgument
引っ込み思案。 このパラメーターは、NULL
[out] phCredential
資格情報ハンドルを受け取る CredHandle 構造体へのポインター。
[out, optional] ptsExpiry
返された資格情報の有効期限が切れる時刻を受け取る TimeStamp 構造体へのポインター。 受け取る構造体の値はセキュリティ パッケージによって異なります。この値はローカル時刻で指定する必要があります。
戻り値
関数が成功した場合は、SEC_E_OKを返します。
関数が失敗すると、次のいずれかのエラー コードが返されます。
リターン コード | 形容 |
---|---|
|
要求されたアクションを完了するために使用できるメモリが不足しています。 |
|
SSPI エラー コードにマップされていないエラーが発生しました。 |
|
セキュリティ パッケージのでは、資格情報を使用できません。 |
|
関数の呼び出し元には、必要な資格情報がありません。 |
|
要求されたセキュリティ パッケージが存在しません。 |
|
パッケージに指定された資格情報が認識されませんでした。 |
備考
AcquireCredentialsHandle (CredSSP) 関数は、特定の セキュリティ パッケージによって使用される、ユーザーやクライアントなどのプリンシパルの資格情報へのハンドルを返します。 この関数は、既存の資格情報または新しく作成された資格情報のいずれかにハンドルを返して返すことができます。 このハンドルは、
一般に、AcquireCredentialsHandle (CredSSP)
パッケージは、RPC ランタイム トランスポートによって提供される pGetKeyFn
カーネル モードの呼び出し元の場合は、次の相違点に注意する必要があります。
- 2 つの文字列パラメーターは、Unicode 文字列
する必要があります。 - バッファー値は、プールからではなく、プロセス仮想メモリに割り当てる必要があります。
手記
sspi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして AcquireCredentialsHandle を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされる最小サーバー | Windows Server 2008 [デスクトップ アプリのみ] |
ターゲット プラットフォーム の |
ウィンドウズ |
ヘッダー | sspi.h (Security.h を含む) |
ライブラリ | Secur32.lib |
DLL | Secur32.dll |
関連項目
AcceptSecurityContext (CredSSP)
InitializeSecurityContext (CredSSP) の