IConman::GetServerFromServerGuid (Windows Embedded CE 6.0)
1/5/2010
This method retrieves a pointer to the server object interface used for connection to the datastore.
In Windows Embedded CE 6.0, CoreCon HLAPI has been deprecated.
Syntax
HRESULT STDMETHODCALLTYPE GetServerFromServerGuid(
REFGUID in_guidServer,
IConManServer** out_ppunkServer
);
Parameters
- in_guidServer
The GUID of the server/
- out_ppunkServer
Pointer to the object interface for the server.
Return Value
The following table shows return values for this method.
| Value | Description |
|---|---|
S_OK |
Indicates the call was successful. |
E_CONMAN_GUIDNOTFOUND |
Indicates the server ID is invalid. |
E_INVALIDARG |
Indicates one or more arguments were null. |
E_FAIL |
Indicates a non-specific failure. |
Remarks
If the server has not been created, the method creates the server, then attempts to connect and cache the resulting interface.
If the connection attempt fails, the method returns an error and purges the GUID from the cache.
Requirements
| Header | conman.h |
| Windows Embedded CE | Windows CE 5.0 and later |