Sm_PolicyApi_GetAgentByName()
szAgentName によって識別されたエージェントの内容を取得します。この関数の結果は、ppstructAgent によって参照される構造で返されます。
casso1283
szAgentName
によって識別されたエージェントの内容を取得します。この関数の結果は、ppstructAgent
によって参照される構造で返されます。この構造に割り当てられたメモリは、Sm_PolicyApi_FreeMemoryEx() を呼び出すことによって解放します。
Type
エージェント関数、グローバル範囲。
構文
int SM_EXTERN Sm_PolicyApi_GetAgentByName (void*pSessionHandle,const char*pszAgentName,Sm_PolicyApi_Agent_t**ppstructAgent);
パラメータ | I/O | 説明 |
pSessionHandle | I | 内部ポリシー管理 API データ構造体へのポインタ。この構造体は、管理者セッションおよびクライアント セッションに関する情報を保持します。 |
pszAgentName | I | 既存のエージェントの名前が含まれ、NULL で終わる文字列です。 |
ppstructAgent | O | エージェント構造へのポインタのアドレスです。 |
戻り値
- Sm_PolicyApi_Success。取得の操作が成功しました。
- Sm_PolicyApi_Failure。Sm_PolicyApi_Agent_t にメモリを割り当てることができませんでした。
- Sm_PolicyApi_InvalidHandle。このコールに先立つ有効な初期化はありませんでした。
- Sm_PolicyApi_NoSession。有効な管理者セッションがありません。
- Sm_PolicyApi_NoPrivilege。管理者には、エージェントを取得する権限がありません。
- Sm_PolicyApi_NotFound。指定された名前でのエージェントが見つかりません。