RPC_AUTH_KEY_RETRIEVAL_FN コールバック関数 (rpcdce.h)

RPC_AUTH_KEY_RETRIEVAL_FN関数は、暗号化キーを返すサーバー アプリケーションによって提供されるルーチンのアドレスを指定する関数のプロトタイプです。

構文

RPC_AUTH_KEY_RETRIEVAL_FN RpcAuthKeyRetrievalFn;

void RpcAuthKeyRetrievalFn(
  void *Arg,
  RPC_WSTR ServerPrincName,
  unsigned long KeyVer,
  void **Key,
  RPC_STATUS *Status
)
{...}

パラメーター

Arg

ユーザー指定の暗号化キー取得関数へのユーザー定義引数へのポインター。 RPC ランタイム ライブラリでは、RpcServerRegisterAuthInfo に指定された Arg パラメーターを使用します。

ServerPrincName

リモート プロシージャ 呼び出しの認証時にサーバーに使用するプリンシパル名へのポインター。 RPC ランタイム ライブラリでは、RpcServerRegisterAuthInfo に指定された ServerPrincName パラメーターを使用します。

KeyVer

RPC ランタイム ライブラリが key-version パラメーターに自動的に提供する値。 値が 0 の場合、取得関数は使用可能な最新のキーを返す必要があります。

Key

ユーザー指定の関数によって返される認証キーへのポインターへのポインター。

Status

クライアント RPC 要求を認証するために RPC ランタイム ライブラリによって呼び出されたときに取得関数によって返される状態へのポインター。 状態がRPC_S_OK以外の場合、要求は失敗し、ランタイム ライブラリはエラー状態をクライアント アプリケーションに返します。

戻り値

なし

解説

承認キー取得関数は、暗号化キーを返すサーバー アプリケーション提供のルーチンのアドレスを指定します。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	rpcdce.h (Rpc.h を含む)

こちらもご覧ください

RpcServerRegisterAuthInfo