GetServiceSDO Method of the ISdoMachine Interface

The GetServiceSDO method retrieves a Server Data Object (SDO) for the specified service.

HRESULT GetServiceSDO(
  [in]                 IASDATASTORE eDataStore,
  [in]                 BSTR bstrServiceName,
  [out]                IUnknown** ppServiceSDO
);

Parameters

  • eDataStore
    Specifies a value from the IASDATASTORE enumeration type.

  • bstrServiceName
    Specifies a BSTR that contains the service name. This parameter is one of the following values.

    String value Meaning

    "IAS"

    Internet Authentication Service

  • ppServiceSDO
    Pointer to a pointer that points to an IUnknown interface pointer. Use the QueryInterface method of this IUnknown interface to obtain an IDispatch interface for the ISdoServiceControl object.

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.

None of the parameters for this method 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 Service SDO

Send comments about this topic to Microsoft

Build date: 10/15/2007