ImportSecurityContextA 関数 (sspi.h)

  • [アーティクル]

ImportSecurityContext 関数は、セキュリティ コンテキストをインポートします。 セキュリティ コンテキストは、ExportSecurityContext の以前の呼び出しによって ImportSecurityContext を呼び出すプロセスにエクスポートされている必要があります。

構文

SECURITY_STATUS SEC_ENTRY ImportSecurityContextA(
  [in]           LPSTR       pszPackage,
  [in]           PSecBuffer  pPackedContext,
  [in, optional] VOID        *Token,
  [out]          PCtxtHandle phContext
);

パラメーター

[in] pszPackage

セキュリティ コンテキストがエクスポートされたセキュリティ パッケージの名前を含む文字列。

[in] pPackedContext

ExportSecurityContext によって作成されたシリアル化されたセキュリティ コンテキストを含むバッファーへのポインター。

[in, optional] Token

コンテキストのトークンへのハンドル。

[out] phContext

pPackedContext から作成された新しいセキュリティ コンテキストのハンドル。 コンテキストの使用が完了したら、 DeleteSecurityContext 関数を呼び出して削除します。

戻り値

関数が成功した場合、関数はSEC_E_OKを返します。

関数が失敗すると、次のいずれかのエラー コードが返されます。

リターン コード 説明
SEC_E_UNKNOWN_CREDENTIALS
 パッケージに指定された資格情報が認識されませんでした。
SEC_E_NO_CREDENTIALS
 セキュリティ パッケージで使用できる資格情報はありません。
SEC_E_NOT_OWNER
 関数の呼び出し元には、必要な資格情報がありません。
SEC_E_INSUFFICIENT_MEMORY
 要求されたアクションを完了するのに十分なメモリがありません。
SEC_E_INTERNAL_ERROR
 SSPI エラー コードにマップされないエラーが発生しました。

注釈

注意

sspi.h ヘッダーは、ImportSecurityContext をエイリアスとして定義します。このエイリアスは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー sspi.h (Security.h を含む)
Library Secur32.lib
[DLL] Secur32.dll

こちらもご覧ください

ExportSecurityContext

FreeContextBuffer

SSPI 関数