SmDirInitUserInstance()

stmndr ポリシー サーバは、指定されたディレクトリ インスタンス上のディレクトリ エントリ(ユーザ)操作関数のいずれかを呼び出す前に SmDirInitUserInstance() を呼び出します。
casso1283
SiteMinder
ポリシー サーバは、特定のディレクトリ インスタンス上のディレクトリ エントリ(ユーザ)操作関数のいずれかを呼び出す前に 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 によって参照されたハンドルは、後続のディレクトリ エントリ(ユーザ)操作関数に渡されます。ハンドル値を変更できます。
SiteMinder
は、関連するディレクトリ エントリ(ユーザ)操作関数の呼び出しを完了した後、SmDirReleaseInstance() を呼び出します。この呼び出しが実行される場合に UserHandle_t を解放します。ユーザ インスタンス ハンドルとディレクトリ インスタンス ハンドルを区別するために
nTag
の値を使用します。