Interface IMobileactivationApi

Namespace: iMobileDevice.Mobileactivation

Assembly: iMobileDevice-net.dll

Syntax

public interface IMobileactivationApi

Properties

| Improve this Doc View Source

Parent

Gets or sets the which owns this iMobileDevice.Mobileactivation.

Declaration

ILibiMobileDevice Parent { get; }

Property Value

Type	Description
ILibiMobileDevice

Methods

| Improve this Doc View Source

mobileactivation_activate(MobileactivationClientHandle, PlistHandle)

Activates the device with the given activation record. The activation record plist dictionary must be obtained using the activation protocol requesting from Apple's https webservice.

Declaration

MobileactivationError mobileactivation_activate(MobileactivationClientHandle client, PlistHandle activationRecord)

Parameters

Type	Name	Description
MobileactivationClientHandle	client	The mobileactivation client
PlistHandle	activationRecord

Returns

Type	Description
MobileactivationError	MOBILEACTIVATION_E_SUCCESS on success, or an MOBILEACTIVATION_E_* error code otherwise.

| Improve this Doc View Source

mobileactivation_activate_with_session(MobileactivationClientHandle, PlistHandle)

Activates the device with the given activation record in 'session' mode. The activation record plist dictionary must be obtained using the activation protocol requesting from Apple's https webservice.

Declaration

MobileactivationError mobileactivation_activate_with_session(MobileactivationClientHandle client, PlistHandle activationRecord)

Parameters

Type	Name	Description
MobileactivationClientHandle	client	The mobileactivation client
PlistHandle	activationRecord

Returns

Type	Description
MobileactivationError	MOBILEACTIVATION_E_SUCCESS on success, or an MOBILEACTIVATION_E_* error code otherwise.

| Improve this Doc View Source

mobileactivation_client_free(IntPtr)

Disconnects a mobileactivation client from the device and frees up the mobileactivation client data.

Declaration

MobileactivationError mobileactivation_client_free(IntPtr client)

Parameters

Type	Name	Description
System.IntPtr	client	The mobileactivation client to disconnect and free.

Returns

Type	Description
MobileactivationError	MOBILEACTIVATION_E_SUCCESS on success, MOBILEACTIVATION_E_INVALID_ARG when one of client or client->parent is invalid, or MOBILEACTIVATION_E_UNKNOWN_ERROR when the was an error freeing the parent property_list_service client.

| Improve this Doc View Source

mobileactivation_client_new(iDeviceHandle, LockdownServiceDescriptorHandle, out MobileactivationClientHandle)

Connects to the mobileactivation service on the specified device.

Declaration

MobileactivationError mobileactivation_client_new(iDeviceHandle device, LockdownServiceDescriptorHandle service, out MobileactivationClientHandle client)

Parameters

Type	Name	Description
iDeviceHandle	device	The device to connect to.
LockdownServiceDescriptorHandle	service	The service descriptor returned by lockdownd_start_service.
MobileactivationClientHandle	client	Reference that will point to a newly allocated mobileactivation_client_t upon successful return.

Returns

Type	Description
MobileactivationError	MOBILEACTIVATION_E_SUCCESS on success, MOBILEACTIVATION_E_INVALID_ARG when one of the parameters is invalid, or MOBILEACTIVATION_E_MUX_ERROR when the connection failed.

| Improve this Doc View Source

mobileactivation_client_start_service(iDeviceHandle, out MobileactivationClientHandle, String)

Starts a new mobileactivation service on the specified device and connects to it.

Declaration

MobileactivationError mobileactivation_client_start_service(iDeviceHandle device, out MobileactivationClientHandle client, string label)

Parameters

Type	Name	Description
iDeviceHandle	device	The device to connect to.
MobileactivationClientHandle	client	Pointer that will point to a newly allocated mobileactivation_client_t upon successful return. Must be freed using mobileactivation_client_free() after use.
System.String	label	The label to use for communication. Usually the program name. Pass NULL to disable sending the label in requests to lockdownd.

Returns

Type	Description
MobileactivationError	MOBILEACTIVATION_E_SUCCESS on success, or an MOBILEACTIVATION_E_* error code otherwise.

| Improve this Doc View Source

mobileactivation_create_activation_info(MobileactivationClientHandle, out PlistHandle)

Retrieves the activation info required for device activation.

Declaration

MobileactivationError mobileactivation_create_activation_info(MobileactivationClientHandle client, out PlistHandle info)

Parameters

Type	Name	Description
MobileactivationClientHandle	client	The mobileactivation client
PlistHandle	info	Pointer to a plist_t variable that will be set to the activation info created by the mobileactivation service. The consumer is responsible for freeing the returned object using plist_free().

Returns

Type	Description
MobileactivationError	MOBILEACTIVATION_E_SUCCESS on success, or an MOBILEACTIVATION_E_* error code otherwise.

| Improve this Doc View Source

mobileactivation_create_activation_info_with_session(MobileactivationClientHandle, PlistHandle, out PlistHandle)

Retrieves the activation info required for device activation in 'session' mode. This function expects a handshake result retrieved from https://albert.apple.com/deviceservies/drmHandshake with a blob provided by mobileactivation_create_activation_session_info().

Declaration

MobileactivationError mobileactivation_create_activation_info_with_session(MobileactivationClientHandle client, PlistHandle handshakeResult, out PlistHandle info)

Parameters

Type	Name	Description
MobileactivationClientHandle	client	The mobileactivation client
PlistHandle	handshakeResult
PlistHandle	info	Pointer to a plist_t variable that will be set to the activation info created by the mobileactivation service. The consumer is responsible for freeing the returned object using plist_free().

Returns

Type	Description
MobileactivationError	MOBILEACTIVATION_E_SUCCESS on success, or an MOBILEACTIVATION_E_* error code otherwise.

| Improve this Doc View Source

mobileactivation_create_activation_session_info(MobileactivationClientHandle, out PlistHandle)

Retrieves a session blob required for 'drmHandshake' via albert.apple.com.

Declaration

MobileactivationError mobileactivation_create_activation_session_info(MobileactivationClientHandle client, out PlistHandle blob)

Parameters

Type	Name	Description
MobileactivationClientHandle	client	The mobileactivation client
PlistHandle	blob	Pointer to a plist_t variable that will be set to the session blob created by the mobielactivation service. The consumer is responsible for freeing the returned object using plist_free().

Returns

Type	Description
MobileactivationError	MOBILEACTIVATION_E_SUCCESS on success, or an MOBILEACTIVATION_E_* error code otherwise.

| Improve this Doc View Source

mobileactivation_deactivate(MobileactivationClientHandle)

Deactivates the device.

Declaration

MobileactivationError mobileactivation_deactivate(MobileactivationClientHandle client)

Parameters

Type	Name	Description
MobileactivationClientHandle	client	The mobileactivation client

Returns

Type	Description
MobileactivationError

| Improve this Doc View Source

mobileactivation_get_activation_state(MobileactivationClientHandle, out PlistHandle)

Retrieves the device's activation state.

Declaration

MobileactivationError mobileactivation_get_activation_state(MobileactivationClientHandle client, out PlistHandle state)

Parameters

Type	Name	Description
MobileactivationClientHandle	client	The mobileactivation client.
PlistHandle	state	Pointer to a plist_t variable that will be set to the activation state reported by the mobileactivation service. The consumer is responsible for freeing the returned object using plist_free().

Returns

Type	Description
MobileactivationError	MOBILEACTIVATION_E_SUCCESS on success, or an MOBILEACTIVATION_E_* error code otherwise.