CmGetToUpdateConnectionConfig (Compact 2013)
3/26/2014
Retrieves settings associated with an earlier configured connection with the intention of updating them. The returned change handle is freed in the subsequent call to CmUpdateConnectionConfig.
Syntax
CM_RESULT CmGetToUpdateConnectionConfig(
__in const WCHAR* pszConnection,
__inout_bcount(*pcbConfig) CM_CONNECTION_CONFIG* pConfig,
__inout DWORD* pcbConfig,
__out CM_CONFIG_CHANGE_HANDLE* phConfig);
Parameters
- pszConnection
[in] Pointer to the connection name as provided by CmEnumConnectionsConfig.
- pConfig
[in] Pointer to a set of CM_CONNECTION_CONFIG structures.
- pcbConfig
[in] Pointer to the number of CM_CONNECTION_CONFIG structures in the pConfig list.
phConfig
[in] Pointer to a storage area to place the output.[out] Pointer to a CM_CONFIG_CHANGE_HANDLE.
Return Value
Returns one of the following values from the CM_RESULT enumeration:
Value |
Description |
|---|---|
CMRE_SUCCESS |
The operation completed successfully. |
CMRE_INVALID_PARAMETER |
One of the parameters in NULL or invalid. |
CMRE_INSUFFICIENT_BUFFER |
An output buffer is too small to contain the results of the call. |
CMRE_INVALID_VERSION |
The Connection Manager Common Constants of one or more of the structure parameters is not supported. |
Requirements
Header |
cmnet.h |
Library |
cmnet.lib |