SmDirGetDirObjInfo()

The stmndr Policy Server calls SmDirGetDirObjInfo() to get information about the object specified in the lpszObject buffer. You can use this function to get the following information about the object passed in as lpszObject:
casso1283
The
SiteMinder
Policy Server calls SmDirGetDirObjInfo() to get information about the object specified in the
lpszObject
buffer. You can use this function to get the following information about the object passed in as
lpszObject
:
  • Distinguished Name (
    lpszDN
    )
  • Class (
    lpszClass
    )
  • Policy Resolution (
    pnSmPolicyResolution
    )
The
SiteMinder
Policy Server calls SmDirFreeString() to free the
lpszDN
and
lpszClass
buffers.
Syntax
int SM_EXTERN SmDirGetDirObjInfo (
   const Sm_Api_Context_t*  lpApiContext,
   void*                    pHandle,
   void*                    pInstanceHandle,
   const char*              lpszObject,
   char**                   lpszDN,
   char**                   lpszClass,
   int*                     pnSmPolicyResolution
);
Parameter
I/O
Description
lpApiContext
I
Pointer to the API context structure.
pHandle
I
The address of the pointer returned by SmDirInit().
pInstanceHandle
I
The address of a pointer to the directory instance handle.
lpszObject
I
The string containing the null-terminated string of the user name.
lpszDN
O
Fill in the user distinguished name resolved from the
lpszObject
.
lpszClass
O
Fill in the class of the resolved user distinguished name.
pnSmPolicyResolution
O
Fill in the Policy resolution of the resolved user distinguished name. Policy resolutions are enumerated in Sm_PolicyResolution_t.
Returns
Returns 0 if successful or -1 if not successful.
Remarks
This function is called in the following circumstances:
  • Searching for a user
  • Enabling or disabling a user account
Sample Code Information
If you are disabling user account Mikel, Mikel is passed in as
lpszObject
. Using the sample code, the following values are returned:
Parameter
Value
lpszDN
Mikel
lpszClass
User
pnSmPolicyResolution
1