IVoIPConfigurationDataStore::UpdateSettingsFromServer (Windows CE 5.0)
This method updates all of the specified settings in the data store using information from the specified LDAP server.
The values must be stored on the LDAP server using names that correspond to the settings to update. For more information about the LDAP name to use for each setting, see CONFIG_DATA_.
HRESULT UpdateSettingsFromServer( const WCHAR *c_wszServerName, WCHAR* ldap_cred, ULONG ldap_method, UINT fSettingsToUpdate, UINT* pfUpdatedSettings);
Parameters
- c_wszServerName
The name of the LDAP server that holds the values to retrieve. - ldap_cred
LDAP credentials that follow the format described in ldap_bind_s. - ldap_method
LDAP authentication method, as described in the ldap_bind_s documentation. - fSettingsToUpdate
A single number that represents all settings to be updated, using CONFIG_DATA_ constants. Multiple settings can be specified by combining multiple CONFIG_DATA_ values using the OR operator. - pfUpdatedSettings
Pointer to a caller-allocated UINT that this method uses to store a single number that consists of CONFIG_DATA_ values combined using the OR operator. This number represents all settings that were successfully updated. Settings that have been overridden manually by the phone's user won't be updated. If this parameter is NULL, this method does not return the successfully updated settings.
Return Values
This method can return LDAP or network error values.
The following table shows additional possible return values.
| Value | Description |
|---|---|
| E_INVALIDARG | The fSettingsToUpdate parameter is zero and does not specify any settings to update. |
| E_POINTER | The address in c_wszServerName is not valid. |
| S_OK | The settings specified in the pfUpdatedSettings output parameter were updated successfully. |
| VOIP_E_NOTINITIALIZED | The data store is not initialized. It must be initialized using IVoIPConfigurationDataStore::Initialize. |
Requirements
OS Versions: Windows CE 5.0 and later.
Header: Voipconfigurationdatastore.idl, Voipconfigurationdatastore.h.
Link Library: Voipguid.lib.
See Also
IVoIPConfigurationDataStore | ldap_bind_s | IVoIPConfigurationDataStore::Initialize
Send Feedback on this topic to the authors