IAccPreferences Interface Reference

---

Detailed Description

The IAccPreferences interface is for getting/setting server-based or local preferences.

Public Types

• enum AccPermissions {
    AccPermissions_Ask = 0,
    AccPermissions_RejectAll = 1,
    AccPermissions_AcceptAll = 2
  }
• enum AccPrivacyMode {
    AccPrivacyMode_DenyNone = 1,
    AccPrivacyMode_PermitNone = 2,
    AccPrivacyMode_Permit = 3,
    AccPrivacyMode_Deny = 4,
    AccPrivacyMode_PermitBuddies = 5
  }
• enum AccProxyProtocol {
    AccProxyProtocol_None = 0,
    AccProxyProtocol_Socks4 = 1,
    AccProxyProtocol_Socks5 = 2,
    AccProxyProtocol_Http = 3,
    AccProxyProtocol_Https = 4
  }
• enum AccRegistrationStatus {
    AccRegistrationStatus_NoDisclosure = 1,
    AccRegistrationStatus_LimitedDisclosure,
    AccRegistrationStatus_FullDisclosure
  }
• enum AccWebPresencePrivacyMode {
    AccWebPresencePrivacyMode_UsePrivacyMode = 0,
    AccWebPresencePrivacyMode_DenyNone = 1,
    AccWebPresencePrivacyMode_PermitNone = 2
  }
• typedef enum
  IAccPreferences::AccPermissions AccPermissions
• typedef enum
  IAccPreferences::AccPrivacyMode AccPrivacyMode
• typedef enum
  IAccPreferences::AccProxyProtocol AccProxyProtocol
• typedef enum
  IAccPreferences::AccRegistrationStatus AccRegistrationStatus
• typedef enum
  IAccPreferences::AccWebPresencePrivacyMode AccWebPresencePrivacyMode

Public Member Functions

• HRESULT GetValue ([in] xp_kstr specifier,[out, retval] xp_variant *value)
• HRESULT RequestValue ([in] xp_kstr specifier,[out, retval] AccTransId *pTransId)
• HRESULT GetDefaultValue ([in] xp_kstr specifier,[out, retval] xp_variant *value)
• HRESULT SetValue ([in] xp_kstr specifier,[in] xp_kvariant value)
• HRESULT Reset ([in] xp_kstr specifier)
• HRESULT GetChildSpecifiers ([in] xp_kstr specifier,[out, retval] xp_variant *value)

---

Member Typedef Documentation

typedef enum IAccPreferences::AccPermissions IAccPreferences::AccPermissions

perhaps definitions of constants should go into another idl file

Values for permissions preferences, e.g. aimcc.av.audio.permissions.buddies

typedef enum IAccPreferences::AccPrivacyMode IAccPreferences::AccPrivacyMode

Values for the privacy mode preference, aimcc.privacy.mode.

typedef enum IAccPreferences::AccProxyProtocol IAccPreferences::AccProxyProtocol

Values for the proxy type preference, aimcc.connect.proxy.protocol.

typedef enum IAccPreferences::AccRegistrationStatus IAccPreferences::AccRegistrationStatus

Values for the registration status preference, aimcc.privacy.registrationStatus.

typedef enum IAccPreferences::AccWebPresencePrivacyMode IAccPreferences::AccWebPresencePrivacyMode

Values for the web presence privacy mode preference, aimcc.privacy.webPresenceMode.

---

Member Enumeration Documentation

enum IAccPreferences::AccPermissions

perhaps definitions of constants should go into another idl file

Values for permissions preferences, e.g. aimcc.av.audio.permissions.buddies

Enumerator:

AccPermissions_Ask
AccPermissions_RejectAll
AccPermissions_AcceptAll

enum IAccPreferences::AccPrivacyMode

Values for the privacy mode preference, aimcc.privacy.mode.

Enumerator:

AccPrivacyMode_DenyNone
AccPrivacyMode_PermitNone
AccPrivacyMode_Permit
AccPrivacyMode_Deny
AccPrivacyMode_PermitBuddies

enum IAccPreferences::AccProxyProtocol

Values for the proxy type preference, aimcc.connect.proxy.protocol.

Enumerator:

AccProxyProtocol_None
AccProxyProtocol_Socks4
AccProxyProtocol_Socks5
AccProxyProtocol_Http
AccProxyProtocol_Https

enum IAccPreferences::AccRegistrationStatus

Values for the registration status preference, aimcc.privacy.registrationStatus.

Enumerator:

AccRegistrationStatus_NoDisclosure
AccRegistrationStatus_LimitedDisclosure
AccRegistrationStatus_FullDisclosure

enum IAccPreferences::AccWebPresencePrivacyMode

Values for the web presence privacy mode preference, aimcc.privacy.webPresenceMode.

Enumerator:

AccWebPresencePrivacyMode_UsePrivacyMode
AccWebPresencePrivacyMode_DenyNone
AccWebPresencePrivacyMode_PermitNone

---

Member Function Documentation

HRESULT IAccPreferences::GetValue	(	[in] xp_kstr	specifier,
		[out, retval] xp_variant *	value
	)

Gets the specified preference.

HRESULT IAccPreferences::RequestValue	(	[in] xp_kstr	specifier,
		[out, retval] AccTransId *	pTransId
	)

Requests the specified preference. The result arrives via DAccEvents::OnPreferenceResult.

HRESULT IAccPreferences::GetDefaultValue	(	[in] xp_kstr	specifier,
		[out, retval] xp_variant *	value
	)

Gets a default for the specified preference. GetValue() calls this. You generally will only call this directly when resetting a preference to its default value.

HRESULT IAccPreferences::SetValue	(	[in] xp_kstr	specifier,
		[in] xp_kvariant	value
	)

Sets the specified preference.

HRESULT IAccPreferences::Reset

(

[in] xp_kstr

specifier

)

Reset the specified preference. Append "." to the specifier to make it recursive.

HRESULT IAccPreferences::GetChildSpecifiers	(	[in] xp_kstr	specifier,
		[out, retval] xp_variant *	value
	)

Returns all immediate child preference specifiers.