Sm_AgentApi_SetDefaultAgentId()

中央ホスト設定によって設定される v5.x 以降のエージェントの名前を設定します。
casso127jpjp
中央ホスト設定によって設定される v5.x 以降のエージェントの名前を設定します。
構文
int SM_EXTERN Sm_AgentApi_SetDefaultAgentId(
   const char *pszAgentIdentity,
   void* pHandle
);
パラメータ
I/O
説明
pszAgentIdentity
I
デフォルト エージェント名として設定する名前を指定します。この名前は、ポリシー サーバ 上の対応するエージェント オブジェクトの名前に一致する必要があります。
pHandle
I
Sm_AgentApi_Init() の
ppHandle
パラメータで返されるエージェント API セッション ハンドル。
戻り値
  • SM_AGENTAPI_SUCCESS。デフォルト エージェント名は正常に設定されました。
  • SM_AGENTAPI_FAILURE。パラメータ
    pszAgentIdentity
    が Null であったか、または SM_AGENTAPI_SIZE_NAME を超えていました。
  • SM_AGENTAPI_NOCONNECTION。パラメータ
    pHandle
    が Null でした。
注釈
この関数は、Sm_AgentApi_Init() をコールした後、エージェント API 内の他の関数をコールする前にコールします。そうすることで、エージェント API 要求ごとにエージェントの名前を渡す必要がなくなります。
この関数は、中央ホスト設定によって設定される v5 以降のカスタム エージェントのみで使用されます。