Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This enumeration represents UPnP AV Framework return values as well as errors defined by the UPnP AV DCP.

Most of these errors are useful in both control points and devices. A subset of errors are useful only on a UPnP AV control. These errors are marked below as control point-only errors.

All but one of the errors in this enumeration are errors explicitly returned by implementation code. ERROR_AV_UPNP_ERROR is an exception: this error is raised when a network communication or other undefined error occurs that prevents a control point from receiving a valid response from the device. You can use GetLastErrorto find more information about the specific problem that caused this error.

For more information about the error codes defined by the UPnP AV DCP, see UPnP AV DCP Documentation.

Syntax 

enum UPnPAVError
{
	SUCCESS_AV						 = 0,
	// Internal AV Toolkit only errors
	ERROR_AV_POINTER				 = -1,
	ERROR_AV_OOM					 = -2,
	ERROR_AV_INVALID_INSTANCE		= -3,
	ERROR_AV_INVALID_STATEVAR		= -4,
	ERROR_AV_ALREADY_INITED			= -5,
	// Internal AV Toolkit Control Point errors
	ERROR_AV_NONEXISTANT_SERVICE	 = -6,
	ERROR_AV_NO_MORE_ITEMS			 = -7,
	ERROR_AV_UPNP_ERROR				= -8,
	ERROR_AV_INVALID_OUT_ARGUMENTS	 = -9,
	// Standard UPnP Errors
	ERROR_AV_UPNP_INVALID_ACTION	 = FAULT_INVALID_ACTION,
	ERROR_AV_UPNP_ACTION_FAILED		=
FAULT_DEVICE_INTERNAL_ERROR,
	// ConnectionManager Errors
	ERROR_AV_UPNP_CM_INCOMPATIBLE_PROTOCOL				= 701,
	ERROR_AV_UPNP_CM_INCOMPATIBLE_DIRECTION				 = 702,
	ERROR_AV_UPNP_CM_INSUFFICIENT_NET_RESOURCES			 = 703,
	ERROR_AV_UPNP_CM_LOCAL_RESTRICTIONS					 = 704,
	ERROR_AV_UPNP_CM_ACCESS_DENIED						= 705,
	ERROR_AV_UPNP_CM_INVALID_CONNECTION_REFERENCE		 = 706,
	ERROR_AV_UPNP_CM_NOT_IN_NETWORK						 = 707,
	// AVTransport Errors
	ERROR_AV_UPNP_AVT_INVALID_TRANSITION					= 701,
	ERROR_AV_UPNP_AVT_NO_CONTENTS						 = 702,
	ERROR_AV_UPNP_AVT_READ_ERROR							= 703,
	ERROR_AV_UPNP_AVT_UNSUPPORTED_PLAY_FORMAT			 = 704,
	ERROR_AV_UPNP_AVT_TRANSPORT_LOCKED					= 705,
	ERROR_AV_UPNP_AVT_WRITE_ERROR						 = 706,
	ERROR_AV_UPNP_AVT_PROTECTED_MEDIA					 = 707,
	ERROR_AV_UPNP_AVT_UNSUPPORTED_REC_FORMAT				= 708,
	ERROR_AV_UPNP_AVT_FULL_MEDIA							= 709,
	ERROR_AV_UPNP_AVT_UNSUPPORTED_SEEK_MODE				 = 710,
	ERROR_AV_UPNP_AVT_ILLEGAL_SEEK_TARGET				 = 711,
	ERROR_AV_UPNP_AVT_UNSUPPORTED_PLAY_MODE				 = 712,
	ERROR_AV_UPNP_AVT_UNSUPPORTED_REC_QUALITY			 = 713,
	ERROR_AV_UPNP_AVT_ILLEGAL_MIME						= 714,
	ERROR_AV_UPNP_AVT_CONTENT_BUSY						= 715,
	ERROR_AV_UPNP_AVT_RESOURCE_NOT_FOUND					= 716,
	ERROR_AV_UPNP_AVT_UNSUPPORTED_PLAY_SPEED				= 717,
	ERROR_AV_UPNP_AVT_INVALID_INSTANCE_ID				 = 718,
	// RenderingControl Errors
	ERROR_AV_UPNP_RC_INVALID_PRESET_NAME					= 701,
	ERROR_AV_UPNP_RC_INVALID_INSTANCE_ID					= 702,
	// ContentDirectory Errors
	ERROR_AV_UPNP_CD_NO_SUCH_OBJECT						 = 701,
	ERROR_AV_UPNP_CD_INVALID_CURRENTTAGVALUE				= 702,
	ERROR_AV_UPNP_CD_INVALID_NEWTAGVALUE					= 703,
	ERROR_AV_UPNP_CD_REQUIRED_TAG_DELETE					= 704,
	ERROR_AV_UPNP_CD_READONLY_TAG_UPDATE					= 705,
	ERROR_AV_UPNP_CD_PARAMETER_NUM_MISMATCH				 = 706,
	ERROR_AV_UPNP_CD_BAD_SEARCH_CRITERIA					= 708,
	ERROR_AV_UPNP_CD_BAD_SORT_CRITERIA					= 709,
	ERROR_AV_UPNP_CD_NO_SUCH_CONTAINER					= 710,
	ERROR_AV_UPNP_CD_RESTRICTED_OBJECT					= 711,
	ERROR_AV_UPNP_CD_BAD_METADATA						 = 712,
	ERROR_AV_UPNP_CD_RESTRICTED_PARENT_OBJECT			 = 713,
	ERROR_AV_UPNP_CD_NO_SUCH_SOURCE_RESOURCE				= 714,
	ERROR_AV_UPNP_CD_SOURCE_RESOURCE_ACCESS_DENIED		= 715,
	ERROR_AV_UPNP_CD_TRANSFER_BUSY						= 716,
	ERROR_AV_UPNP_CD_NO_SUCH_FILE_TRANSFER				= 717,
	ERROR_AV_UPNP_CD_NO_SUCH_DESTINATION_RESOURCE		 = 718,
	ERROR_AV_UPNP_CD_DESTINATION_RESOURCE_ACCESS_DENIED	 = 719,
	ERROR_AV_UPNP_CD_REQUEST_FAILED						 = 720
};

Elements

SUCCESS_AV

Operation completed successfully.

ERROR_AV_POINTER

At least one required pointer is NULL.

ERROR_AV_OOM

Not enough memory was available to complete the operation.

ERROR_AV_INVALID_INSTANCE

The instance ID or pointer was either non-existent (when required), or existed (when not required).

ERROR_AV_INVALID_STATEVAR

The specified state variable name is not valid.

ERROR_AV_ALREADY_INITED

This service class's Initmethod has already been called.

ERROR_AV_NONEXISTANT_SERVICE

A required service does not exist on the device. Used only in UPnP AV control point applications.

ERROR_AV_NO_MORE_ITEMS

There are no more items available in this set. Used only in UPnP AV control point applications.

ERROR_AV_UPNP_ERROR

The UPnP Control Point API returned an error, probably because a network communication or other undefined error prevented a control point from receiving a valid response from the device. Use GetLastErrorto retrieve error details. Used only in UPnP AV control point applications.

ERROR_AV_INVALID_OUT_ARGUMENTS

The specified action returned the wrong number and/or type of outgoing arguments. Used only in UPnP AV control point applications.

ERROR_AV_UPNP_INVALID_ACTION

This service does not support the specified action. This is a standard UPnP error. Evaluates to 401.

ERROR_AV_UPNP_ACTION_FAILED

The current service state prevents invocation of the specified action. This is a standard UPnP error. Evaluates to 501.

ERROR_AV_UPNP_CM_INCOMPATIBLE_PROTOCOL

The protocol information is not valid. The connection cannot be established.

ERROR_AV_UPNP_CM_INCOMPATIBLE_DIRECTION

The directions of the specified ConnectionManager instances are incompatible. The connection cannot be established.

ERROR_AV_UPNP_CM_INSUFFICIENT_NET_RESOURCES

There are insufficient network resources to establish the connection.

ERROR_AV_UPNP_CM_LOCAL_RESTRICTIONS

There are device-side limitations - transient or otherwise - that prevent the establishment of this connection.

ERROR_AV_UPNP_CM_ACCESS_DENIED

The client is not allowed to access the specified ConnectionManager instance. The connection cannot be established.

ERROR_AV_UPNP_CM_INVALID_CONNECTION_REFERENCE

The specified connection is not a valid connection established by this ConnectionManager instance.

ERROR_AV_UPNP_CM_NOT_IN_NETWORK

The specified ConnectionManager instances are not part of the same network. The connection cannot be established.

ERROR_AV_UPNP_AVT_INVALID_TRANSITION

The device does not support the transition to the specified transport state from the current transport state.

ERROR_AV_UPNP_AVT_NO_CONTENTS

The current media contains no data to be played.

ERROR_AV_UPNP_AVT_READ_ERROR

The current media cannot be played.

ERROR_AV_UPNP_AVT_UNSUPPORTED_PLAY_FORMAT

This device does not support playback of the current media's storage format.

ERROR_AV_UPNP_AVT_TRANSPORT_LOCKED

The transport is locked - usually by a hardware button on the device - and cannot be changed.

ERROR_AV_UPNP_AVT_WRITE_ERROR

The current media cannot be written.

ERROR_AV_UPNP_AVT_PROTECTED_MEDIA

The current media is write-protected or is not of a type that can be written.

ERROR_AV_UPNP_AVT_UNSUPPORTED_REC_FORMAT

This device does not support recording to the storage format of the current media.

ERROR_AV_UPNP_AVT_FULL_MEDIA

There is not enough free space on the current media for writing.

ERROR_AV_UPNP_AVT_UNSUPPORTED_SEEK_MODE

The device does not support the specified seek mode.

ERROR_AV_UPNP_AVT_ILLEGAL_SEEK_TARGET

The specified seek target is not valid for the specified seek mode, or is not present in the current media.

ERROR_AV_UPNP_AVT_UNSUPPORTED_PLAY_MODE

The device does not support the specified play more.

ERROR_AV_UPNP_AVT_UNSUPPORTED_REC_QUALITY

The device does not support the specified recording quality.

ERROR_AV_UPNP_AVT_ILLEGAL_MIME

This AVTransport instance does not support the MIME type of the specified resource.

ERROR_AV_UPNP_AVT_CONTENT_BUSY

The specified resource is already being output.

ERROR_AV_UPNP_AVT_RESOURCE_NOT_FOUND

The specified resource cannot be located on the network.

ERROR_AV_UPNP_AVT_UNSUPPORTED_PLAY_SPEED

This AVTransport instance does not support the specified play speed.

ERROR_AV_UPNP_AVT_INVALID_INSTANCE_ID

The specified instance ID is invalid for this AVTransport instance.

ERROR_AV_UPNP_RC_INVALID_PRESET_NAME

The specified name is not a valid preset name.

ERROR_AV_UPNP_RC_INVALID_INSTANCE_ID

The specified RenderingControl instance ID is not valid.

ERROR_AV_UPNP_CD_NO_SUCH_OBJECT

The specified object ID is not valid.

ERROR_AV_UPNP_CD_INVALID_CURRENTTAGVALUE

The tag/value pair(s) specified in the CurrentTagValueparameter do not match the current ContentDirectory state. This can occur if the specified data is out of date.

ERROR_AV_UPNP_CD_INVALID_NEWTAGVALUE

The tag value specified in the NewTagValueparameter is invalid.

ERROR_AV_UPNP_CD_REQUIRED_TAG_DELETE

Required tags cannot be deleted.

ERROR_AV_UPNP_CD_READONLY_TAG_UPDATE

Read-only tags cannot be changed.

ERROR_AV_UPNP_CD_PARAMETER_NUM_MISMATCH

The number of tag/value pairs (including empty placeholders) in CurrentTagValue and NewTagValue do not match.

ERROR_AV_UPNP_CD_BAD_SEARCH_CRITERIA

The specified search criteria is invalid or is not supported.

ERROR_AV_UPNP_CD_BAD_SORT_CRITERIA

The specified sort criteria is invalid or is not supported.

ERROR_AV_UPNP_CD_NO_SUCH_CONTAINER

The container specified by the ContainerIDparameter is invalid or identifies an object that is not a container.

ERROR_AV_UPNP_CD_RESTRICTED_OBJECT

The restricted attribute of the object is true. The operation failed.

ERROR_AV_UPNP_CD_BAD_METADATA

The specified operation would create metadata that is invalid or not allowed. The operation failed.

ERROR_AV_UPNP_CD_RESTRICTED_PARENT_OBJECT

The restricted attributed of the parent object is true. The operation failed.

ERROR_AV_UPNP_CD_NO_SUCH_SOURCE_RESOURCE

The ContentDirectory instance cannot find the specified source resource.

ERROR_AV_UPNP_CD_SOURCE_RESOURCE_ACCESS_DENIED

The ContentDirectory instance cannot access the specified source resource.

ERROR_AV_UPNP_CD_TRANSFER_BUSY

The ContentDirectory instance cannot support another file transfer at this time.

ERROR_AV_UPNP_CD_NO_SUCH_FILE_TRANSFER

The file transfer specified by the TransferIDparameter does not exist.

ERROR_AV_UPNP_CD_NO_SUCH_DESTINATION_RESOURCE

The ContentDirectory instance cannot find the specified destination resource.

ERROR_AV_UPNP_CD_DESTINATION_RESOURCE_ACCESS_DENIED

The ContentDirectory instance cannot access the specified destination resource.

ERROR_AV_UPNP_CD_REQUEST_FAILED

The ContentDirectory instance cannot process the request.

Requirements

Header av_upnp.h
Library Av_upnp.lib
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also