Class MisagentApi

Inheritance

System.Object

MisagentApi

Implements

IMisagentApi

Inherited Members

System.Object.ToString()

System.Object.Equals(System.Object)

System.Object.Equals(System.Object, System.Object)

System.Object.ReferenceEquals(System.Object, System.Object)

System.Object.GetHashCode()

System.Object.GetType()

System.Object.MemberwiseClone()

Namespace: iMobileDevice.Misagent

Assembly: iMobileDevice-net.dll

Syntax

public class MisagentApi : IMisagentApi

Constructors

| Improve this Doc View Source

MisagentApi(ILibiMobileDevice)

Declaration

public MisagentApi(ILibiMobileDevice parent)

Parameters

Type	Name	Description
ILibiMobileDevice	parent

Properties

| Improve this Doc View Source

Parent

Declaration

public ILibiMobileDevice Parent { get; }

Property Value

Type	Description
ILibiMobileDevice

Methods

| Improve this Doc View Source

misagent_client_free(IntPtr)

Disconnects an misagent client from the device and frees up the misagent client data.

Declaration

public virtual MisagentError misagent_client_free(IntPtr client)

Parameters

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

Returns

Type	Description
MisagentError	MISAGENT_E_SUCCESS on success, MISAGENT_E_INVALID_ARG when client is NULL, or an MISAGENT_E_* error code otherwise.

| Improve this Doc View Source

misagent_client_new(iDeviceHandle, LockdownServiceDescriptorHandle, out MisagentClientHandle)

Connects to the misagent service on the specified device.

Declaration

public virtual MisagentError misagent_client_new(iDeviceHandle device, LockdownServiceDescriptorHandle service, out MisagentClientHandle client)

Parameters

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

Returns

Type	Description
MisagentError	MISAGENT_E_SUCCESS on success, MISAGENT_E_INVALID_ARG when client is NULL, or an MISAGENT_E_* error code otherwise.

| Improve this Doc View Source

misagent_client_start_service(iDeviceHandle, out MisagentClientHandle, String)

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

Declaration

public virtual MisagentError misagent_client_start_service(iDeviceHandle device, out MisagentClientHandle client, string label)

Parameters

Type	Name	Description
iDeviceHandle	device	The device to connect to.
MisagentClientHandle	client	Pointer that will point to a newly allocated misagent_client_t upon successful return. Must be freed using misagent_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
MisagentError	MISAGENT_E_SUCCESS on success, or an MISAGENT_E_* error code otherwise.

| Improve this Doc View Source

misagent_copy(MisagentClientHandle, out PlistHandle)

Retrieves all installed provisioning profiles (iOS 9.2.1 or below).

Declaration

public virtual MisagentError misagent_copy(MisagentClientHandle client, out PlistHandle profiles)

Parameters

Type	Name	Description
MisagentClientHandle	client	The connected misagent to use.
PlistHandle	profiles	Pointer to a plist_t that will be set to a PLIST_ARRAY if the function is successful.

Returns

Type	Description
MisagentError	MISAGENT_E_SUCCESS on success, MISAGENT_E_INVALID_ARG when client is invalid, or an MISAGENT_E_* error code otherwise.

Remarks

This API call only works with iOS 9.2.1 or below. For newer iOS versions use misagent_copy_all() instead. If no provisioning profiles are installed on the device, this function still returns MISAGENT_E_SUCCESS and profiles will just point to an empty array.

| Improve this Doc View Source

misagent_copy_all(MisagentClientHandle, out PlistHandle)

Retrieves all installed provisioning profiles (iOS 9.3 or higher).

Declaration

public virtual MisagentError misagent_copy_all(MisagentClientHandle client, out PlistHandle profiles)

Parameters

Type	Name	Description
MisagentClientHandle	client	The connected misagent to use.
PlistHandle	profiles	Pointer to a plist_t that will be set to a PLIST_ARRAY if the function is successful.

Returns

Type	Description
MisagentError	MISAGENT_E_SUCCESS on success, MISAGENT_E_INVALID_ARG when client is invalid, or an MISAGENT_E_* error code otherwise.

Remarks

This API call only works with iOS 9.3 or higher. For older iOS versions use misagent_copy() instead. If no provisioning profiles are installed on the device, this function still returns MISAGENT_E_SUCCESS and profiles will just point to an empty array.

| Improve this Doc View Source

misagent_get_status_code(MisagentClientHandle)

Retrieves the status code from the last operation.

Declaration

public virtual int misagent_get_status_code(MisagentClientHandle client)

Parameters

Type	Name	Description
MisagentClientHandle	client	The misagent to use.

Returns

Type	Description
System.Int32	-1 if client is invalid, or the status code from the last operation

| Improve this Doc View Source

misagent_install(MisagentClientHandle, PlistHandle)

Installs the given provisioning profile. Only works with valid profiles.

Declaration

public virtual MisagentError misagent_install(MisagentClientHandle client, PlistHandle profile)

Parameters

Type	Name	Description
MisagentClientHandle	client	The connected misagent to use for installation
PlistHandle	profile	The valid provisioning profile to install. This has to be passed as a PLIST_DATA, otherwise the function will fail.

Returns

Type	Description
MisagentError	MISAGENT_E_SUCCESS on success, MISAGENT_E_INVALID_ARG when client is invalid, or an MISAGENT_E_* error code otherwise.

| Improve this Doc View Source

misagent_remove(MisagentClientHandle, String)

Removes a given provisioning profile.

Declaration

public virtual MisagentError misagent_remove(MisagentClientHandle client, string profileid)

Parameters

Type	Name	Description
MisagentClientHandle	client	The connected misagent to use.
System.String	profileid

Returns

Type	Description
MisagentError	MISAGENT_E_SUCCESS on success, MISAGENT_E_INVALID_ARG when client is invalid, or an MISAGENT_E_* error code otherwise.

Implements

IMisagentApi