SspiInitializeSecurityContextAsyncA 関数 (sspi.h)

SspiInitializeSecurityContextAsyncA 関数は、資格情報ハンドルからクライアント側の送信セキュリティ コンテキストを開始します。 関数は、クライアント アプリケーションとリモート ピアの間にセキュリティ コンテキストを構築するために使用されます。 SspiInitializeSecurityContextAsyncA は、クライアントがリモート ピアに渡す必要があるトークンを返します。これにより、ピアは SspiAcceptSecurityContextAsync 呼び出しを通じてローカル セキュリティ実装に送信されます。

構文

SECURITY_STATUS SspiInitializeSecurityContextAsyncA(
  SspiAsyncContext *AsyncContext,
  PCredHandle      phCredential,
  PCtxtHandle      phContext,
  LPSTR            pszTargetName,
  unsigned long    fContextReq,
  unsigned long    Reserved1,
  unsigned long    TargetDataRep,
  PSecBufferDesc   pInput,
  unsigned long    Reserved2,
  PCtxtHandle      phNewContext,
  PSecBufferDesc   pOutput,
  unsigned long    *pfContextAttr,
  PTimeStamp       ptsExpiry
);

パラメーター

AsyncContext

非同期呼び出しコンテキスト。

phCredential

AcquireCredentialsHandle によって返される資格情報のハンドル。 このハンドルは、 セキュリティ コンテキストを構築するために使用されます。

phContext

既存の CtxtHandle 構造体へのポインター。

pszTargetName

コンテキストのターゲットを示す null で終わる文字列へのポインター。 文字列の内容は、次の表で説明するように、 セキュリティ パッケージ 固有のものです。 このリストは全てを網羅しているわけではありません。 システム SP とサード パーティの SP をシステムに追加できます。

fContextReq

コンテキストの要求を示すビット フラグ。

フラグ値とその意味の一覧については、「 InitializeSecurityContext: fContextReq 」を参照してください。

Reserved1

このパラメーターは予約済みであり、0 に設定する必要があります。

TargetDataRep

ターゲット上のバイト順序などのデータ表現。 このパラメーターには、SECURITY_NATIVE_DREPまたはSECURITY_NETWORK_DREPを指定できます。

pInput

パッケージへの入力として提供されるバッファーへのポインターを含む SecBufferDesc 構造体へのポインター。

Reserved2

このパラメーターは予約済みであり、0 に設定する必要があります。

phNewContext

CtxtHandle 構造体へのポインター。

pOutput

出力データを受信する SecBuffer 構造体へのポインターを含む SecBufferDesc 構造体へのポインター。

pfContextAttr

確立されたコンテキストの属性を示すビット フラグのセットを受け取る変数へのポインター。 さまざまな属性の説明については、「 コンテキスト要件」を参照してください。

ptsExpiry

オプション。 コンテキストの有効期限を受け取る TimeStamp 構造体へのポインター。

戻り値

セキュリティ コンテキスト を 確立するための非同期要求が正常にキューに登録された場合は、SEC_E_OKを返します。それ以外の場合は、キューに入ろうとして生成されたエラーを返します。 操作の状態を取得するには、 SspiGetAsyncCallStatus を使用します。

サーバーから受信したセキュリティ コンテキストが受け入れられた場合、SspiGetAsyncCallStatus は次の表 に示すSEC_E_OK または SSPI コードのいずれかを返します。 それ以外の場合は、呼び出しがまだ進行中の場合、 または 次の 2 番目の表のいずれかの致命的なエラー コードがSEC_I_ASYNC_CALL_PENDING返される可能性があります。

致命的なエラー コード

注釈

完全な解説については、「 InitializeSecurityContext 」を参照してください。

要件

こちらもご覧ください

SspiAcceptSecurityContextAsync

SspiAcquireCredentialsHandleAsync