SmDirReleaseInstance()

stmndr ポリシー サーバは、必要に応じてユーザ インスタンスまたはディレクトリ インスタンスを解放できるように、SmDirReleaseInstance() を呼び出します。
casso1283
SiteMinder
ポリシー サーバは、必要に応じてユーザ インスタンスまたはディレクトリ インスタンスを解放できるように、SmDirReleaseInstance() を呼び出します。
構文
void SM_EXTERN SmDirReleaseInstance (
   const Sm_Api_Context_t*  lpApiContext,
   void*                    pHandle,
   void*                    pInstanceHandle
);
パラメータ
I/O
説明
lpApiContext
I
API コンテキスト構造へのポインタ。
pHandle
I
SmDirInit() によって返されたポインタのアドレス。
pInstanceHandle
I
ユーザまたはディレクトリ インスタンス ハンドルへのポインタのアドレス。ユーザ インスタンスを解放するには、
pInstanceHandle
にユーザ インスタンス ハンドルが含まれることを確認します。ディレクトリ インスタンスを解放するには、
pInstanceHandle
にディレクトリ インスタンス ハンドルが含まれることを確認します。
注釈
ユーザまたはディレクトリの、渡されるインスタンス ハンドル タイプで機能するようにリリース コードを記述する必要があります。
プロセス中に、
SiteMinder
ポリシー サーバはまず SmDirInitDirInstance() を呼び出し、次に SmDirInitUserInstance() を呼び出す場合があります。その場合、
SiteMinder
ポリシー サーバは、プロセスの最後に 2 回 SmDirReleaseInstance() を呼び出します。最初の呼び出しでは、ユーザ インスタンスを解放できるように、ユーザ インスタンス ハンドルが(
pInstanceHandle
として)渡されます。2 番目の呼び出しでは、ディレクトリ インスタンスを解放できるように、ディレクトリ インスタンス ハンドルが(
pInstanceHandle
として)渡されます。
ユーザ ハンドルとディレクトリ ハンドルを区別するために
nTag
の値を以下のように使用します。
  • ユーザ ハンドルでは、構造 DirHandle_t の
    nTag
    は 0 です。
  • ディレクトリ ハンドルでは、構造 UserHandle_t の
    nTag
    は 1 です。