Share via


PrimarySnapInDataException Class

 

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
System_CAPS_pubmethod PrimarySnapInDataException()

Initializes a new instance of the PrimarySnapInDataException class.

System_CAPS_pubmethod PrimarySnapInDataException(SerializationInfo, StreamingContext)

This is the serialization constructor.

System_CAPS_pubmethod 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.

System_CAPS_pubmethod PrimarySnapInDataException(String, Exception)

Creates a new instance with an inner exception.

Properties

Name Description
System_CAPS_pubproperty Data

(Inherited from Exception.)

System_CAPS_pubproperty HelpLink

(Inherited from Exception.)

System_CAPS_pubproperty InnerException

(Inherited from Exception.)

System_CAPS_pubproperty Message

(Inherited from Exception.)

System_CAPS_pubproperty Source

(Inherited from Exception.)

System_CAPS_pubproperty StackTrace

(Inherited from Exception.)

System_CAPS_pubproperty TargetSite

(Inherited from Exception.)

Methods

Name Description
System_CAPS_pubmethod Equals(Object)

(Inherited from Object.)

System_CAPS_pubmethod GetBaseException()

(Inherited from Exception.)

System_CAPS_pubmethod GetHashCode()

(Inherited from Object.)

System_CAPS_pubmethod GetObjectData(SerializationInfo, StreamingContext)

Serializes to a stream.(Overrides Exception.GetObjectData(SerializationInfo, StreamingContext).)

System_CAPS_pubmethod GetType()

(Inherited from Exception.)

System_CAPS_pubmethod ToString()

(Inherited from Exception.)

Remarks

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

  1. The primary snap-in is shutting down and its data object is disconnected.

  2. The primary snap-in data object does not support the requested clipboard format.

  3. The MMC run-time received a failure HRESULT during a call to IDataObject.

  4. The MMC run-time received invalid out parameters after a call to IDataObject.

  5. 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.

See Also

Microsoft.ManagementConsole.Advanced Namespace

Return to top