PrimarySnapInDataException Class

Article
01/20/2017

Represents the exception that is thrown when an extension fails to read a data object that is shared by a primary snap-in. The extension that receives this exception can catch this exception and continue functioning.

Namespace: Microsoft.ManagementConsole.Advanced
Assembly: Microsoft.ManagementConsole (in Microsoft.ManagementConsole.dll)

Inheritance Hierarchy

System.Object
System.Exception
Microsoft.ManagementConsole.Advanced.PrimarySnapInDataException

Syntax

[SerializableAttribute]
public sealed class PrimarySnapInDataException : Exception

[SerializableAttribute]
public ref class PrimarySnapInDataException sealed : Exception

[<Sealed>]
[<SerializableAttribute>]
type PrimarySnapInDataException = 
    class
        inherit Exception
    end

<SerializableAttribute>
Public NotInheritable Class PrimarySnapInDataException
    Inherits Exception

Constructors

	Name	Description
	PrimarySnapInDataException()	Initializes a new instance of the PrimarySnapInDataException class.
	PrimarySnapInDataException(SerializationInfo, StreamingContext)	This is the serialization constructor.
	PrimarySnapInDataException(String)	Initializes a new instance of the PrimarySnapInDataException class using a customized message as a parameter. This is the constructor that is typically used.
	PrimarySnapInDataException(String, Exception)	Creates a new instance with an inner exception.

Properties

	Name	Description
	Data	(Inherited from Exception.)
	HelpLink	(Inherited from Exception.)
	InnerException	(Inherited from Exception.)
	Message	(Inherited from Exception.)
	Source	(Inherited from Exception.)
	StackTrace	(Inherited from Exception.)
	TargetSite	(Inherited from Exception.)

Methods

	Name	Description
	Equals(Object)	(Inherited from Object.)
	GetBaseException()	(Inherited from Exception.)
	GetHashCode()	(Inherited from Object.)
	GetObjectData(SerializationInfo, StreamingContext)	Serializes to a stream.(Overrides Exception.GetObjectData(SerializationInfo, StreamingContext).)
	GetType()	(Inherited from Exception.)
	ToString()	(Inherited from Exception.)

Remarks

The failure to read can be attributed to any of the following causes:

The primary snap-in is shutting down and its data object is disconnected.
The primary snap-in data object does not support the requested clipboard format.
The MMC run-time received a failure HRESULT during a call to IDataObject.
The MMC run-time received invalid out parameters after a call to IDataObject.
The request to read data has timed out.

Thread Safety

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.