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.

Value Meaning

E_ABORT

The operation was aborted.

E_FAIL

An unspecified error occurred.

E_INVALIDARG

One of the parameters is invalid.

E_NOINTERFACE

A specified interface is not supported.

E_NOTIMPL

A specified method is not implemented.

E_OUTOFMEMORY

The method was unable to allocate required memory.

E_POINTER

A pointer passed as a parameter is not valid.

E_UNEXPECTED

The method failed for unknown reasons.

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

Server

Requires Windows Server 2008, Windows Server 2003, or Windows 2000 Server.

Header

Declared in SdoIas.h.

IDL

Declared in SdoIas.idl.

DLL

Requires Iassdo.dll.

See Also

ISdoMachine
ISdoMachine::Attach
Retrieving a User SDO
USERPROPERTIES

Send comments about this topic to Microsoft

Build date: 10/15/2007