Attach Method of the ISdoMachine Interface
The Attach method attaches to an SDO computer. Attaching to an SDO computer is the first step is using the SDO API to administer that computer.
HRESULT Attach(
[in] BSTR bstrComputerName
);
Parameters
- bstrComputerName
Specifies a BSTR variable that contains the name of the computer to which to attach. If this parameter specifies a NULL string, the local computer is attached.
Return Value
If the method succeeds the return value is S_OK.
If a computer is already 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
Use the ISdoMachine::GetAttachedComputer method to determine if a computer is already attached.
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::GetAttachedComputer
Send comments about this topic to Microsoft
Build date: 10/15/2007