GetAttachedComputer Method of the ISdoMachine Interface

The GetAttachedComputer method retrieves the name of the computer that is currently attached as an SDO computer.

HRESULT GetAttachedComputer(
  [out]                BSTR* bstrComputerName
);

Parameters

  • bstrComputerName
    Pointer to a BSTR that receives the name of the computer that is the currently-attached SDO computer.

Return Value

If the method succeeds the return value is S_OK.

If no computer is currently attached, the return value is E_FAIL.

The method may also return one of the following error codes.

Value Meaning

E_ABORT

The operation was aborted.

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

The GetAttachedComputer allocates the memory for the BSTR variable. The calling application should free this memory by calling SysFreeString.

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

Send comments about this topic to Microsoft

Build date: 10/15/2007