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