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