Sm_PolicyApi_GetDomainByName()

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