GetUserSDO Method of the ISdoMachine Interface

The GetUserSDO method retrieves an interface to the Server Data Object (SDO) for the specified user.

HRESULT GetUserSDO(
  [in]                 IASDATASTORE eDataStore,
  [in]                 BSTR bstrUserName,
  [out]                IUnknown** ppUserSDO
);

Parameters

• eDataStore
  Specifies a value from the IASDATASTORE enumeration type.

• bstrUserName
  Specifies a BSTR that contains the name of the user. The name can be in Light-weight Directory Access Protocol (LDAP) format, or in Security Accounts Manager (SAM) format.

• ppUserSDO
  Pointer to a pointer that points to an IUnknown interface pointer. Use the QueryInterface method of this IUnknown interface to obtain an IDispatch interface to an ISdo object for the specified user.

Return Value

If the method succeeds the return value is S_OK.

If the method fails, the return value is one of the following error codes.

Remarks

Before calling this method, use the ISdoMachine::Attach method to attach to the SDO computer.

If the SDO computer has a directory, then the ISdoMachine::GetUserSDO automatically uses the DATA_STORE_DIRECTORY value of IASDATASTORE instead of DATA_STORE_LOCAL.

None of the parameters can be NULL.

Requirements

See Also

ISdoMachine
ISdoMachine::Attach
Retrieving a User SDO
USERPROPERTIES

Send comments about this topic to Microsoft

Build date: 10/15/2007