SmDirInitUserInstance()
stmndr ポリシー サーバは、特定のディレクトリ インスタンス上のディレクトリ エントリ(ユーザ)操作関数のいずれかを呼び出す前に SmDirInitUserInstance() を呼び出します。
casso127jpjp
CA Single Sign-on
ポリシー サーバは、特定のディレクトリ インスタンス上のディレクトリ エントリ(ユーザ)操作関数のいずれかを呼び出す前に SmDirInitUserInstance() を呼び出します。SmDirInitUserInstance() は複数回呼び出すことができます。
構文
int SM_EXTERN SmDirInitUserInstance (const Sm_Api_Context_t* lpApiContext,void* pHandle,void** ppInstanceHandle,void* pDirInstanceHandle,const char* lpszUserDN);
パラメータ | I/O | 説明 |
lpApiContext
| I | API コンテキスト構造へのポインタ。 |
pHandle
| I | SmDirInit() によって返されたポインタのアドレス。 |
ppInstanceHandle
| O | ユーザ インスタンス セッションのハンドルを保持するポインタのアドレス。 |
pDirInstanceHandle
| I | ディレクトリインスタンス セッションのポインタ ハンドルのアドレス。この値は、SmDirInitDirInstance()から渡されます。 |
lpszUserDN
| I | ユーザ識別名の NULL で終わる文字列が含まれる文字列。 |
戻り値
成功した場合は 0、失敗した場合は -1 を返します。
注釈
SmDirInitUserInstance() が呼び出されるとき、UserHandle_t をインスタンス化します。ユーザ インスタンス ハンドルとディレクトリ インスタンス ハンドルを区別するために
nTag
を 1 に設定します。UserHandle_t によって参照されたハンドルは、後続のディレクトリ エントリ(ユーザ)操作関数に渡されます。ハンドル値を変更できます。
CA Single Sign-on
は、関連するディレクトリ エントリ(ユーザ)操作関数の呼び出しを完了した後、SmDirReleaseInstance() を呼び出します。この呼び出しが実行される場合に UserHandle_t を解放します。ユーザ インスタンス ハンドルとディレクトリ インスタンス ハンドルを区別するために nTag
の値を使用します。