Sm_PolicyApi_GetVariableByName()
指定された変数を取得します。
casso126jjp
指定された変数を取得します。
この関数の結果が
ppstructVariable
によって参照される構造で返されます。この構造に割り当てられたメモリは、Sm_PolicyApi_FreeMemoryEx() を呼び出すことによって解放します。Type
変数関数。
構文
int SM_EXTERN Sm_PolicyApi_GetVariableByName (void*pSessionHandle,const char*pszVariableName,Sm_PolicyApi_Variable_t**ppstructVariable);
パラメータ | I/O | Description |
pSessionHandle
| I | 内部ポリシー管理 API データ構造体へのポインタ。この構造体は、管理者セッションおよびクライアント セッションに関する情報を保持します。 |
pszDomainOid | I | 既存のドメインのオブジェクト識別子が含まれ、NULL で終わる文字列です。 |
pszVariableName
| I | 変数に相当する一意の名前。 |
ppstructVariable
| O | 変数構造へのポインタのアドレス。 |
戻り値
- Sm_PolicyApi_Success。取得は正常に行われました。
- Sm_PolicyApi_Failure。メモリは Sm_PolicyApi_Variable_t に割り当てられることができませんでした。
- Sm_PolicyApi_InvalidHandle。このコールに先立つ有効な初期化はありませんでした。
- Sm_PolicyApi_NoSession。有効な管理者セッションがありません。
- Sm_PolicyApi_NoPrivilege。管理者には、変数を取得する権限がありません。
- Sm_PolicyApi_InvalidOid。ドメイン OID が見つかりませんでした。
- Sm_PolicyApi_NotFound。変数名が見つかりませんでした。
- Sm_PolicyApi_FeatureNotSupported。この関数を呼び出したクライアントが、SM_POLICY_API_VERSION_6_0 より以前のバージョンで API を初期化しました。