Sm_AgentApi_Authorize()

定義済みユーザが定義済みリソースで定義済みのアクションを実行する許可を stmndr によって与えられているかどうかを判別し、そのリソースに対するそのユーザに関するレスポンス属性を返します。
casso126jjp
定義済みユーザが定義済みリソースで定義済みのアクションを実行する許可を
CA Single Sign-on
によって与えられているかどうかを判別し、そのリソースに対するそのユーザに関するレスポンス属性を返します。
構文
int SM_EXTERN Sm_AgentApi_Authorize (
   const void*                            pHandle,
   const char*                            lpszClientIpAddr,
   const char*                            lpszTransactionId,
   const Sm_AgentApi_ResourceContext_t*   pResourceContext,
   const Sm_AgentApi_Realm_t*             pRealm,
   Sm_AgentApi_Session_t*                 pSession,
   long*                                  pNumAttributes,
   Sm_AgentApi_Attribute_t**              ppAttributes
);
パラメータ
I/O
Description
pHandle
I
Sm_AgentApi_Init() の
ppHandle
パラメータで返されるエージェント API セッション ハンドル。
lpszClientIpAddr
I
リソースを要求しているクライアントの IP アドレス。このパラメータは任意です。クライアント IP がアスタリスク(*)で始まる場合、ポリシー サーバはこの IP アドレスをログ記録しますが、セッション仕様に照らした検証は行いません。
lpszTransactionId
I
エージェントがセキュリティ アクティビティをアプリケーション アクティビティに関連付けるために使用する ID。ポリシー サーバはこの ID をログ記録します。これはオプションのパラメータです。
pResourceContext
I
リソース定義構造体。
pRealm
I
レルム定義構造体。
pSession
I
セッション定義構造体。
pNumAttributes
O
返された属性の数。
ppAttributes
O
レスポンス属性定義構造体の配列へのポインタ。
戻り値
  • SM_AGENTAPI_YES。ユーザは許可されています。
  • SM_AGENTAPI_NO。ユーザは許可されていません。
  • SM_AGENTAPI_NOCONNECTION。初期化できませんでした。
  • SM_AGENTAPI_FAILURE。サーバにアクセスできませんでした。
  • SM_AGENTAPI_TIMEOUT。関数がタイム アウトしました。
この関数の例については、サンプル smagentexample.cpp を参照してください。