Platform namespace (C++/CX)

Article
08/03/2021

Contains built-in types that are compatible with the Windows Runtime.

Syntax

using namespace Platform;

Members

Attributes

The Platform namespace contains attributes, classes, enumerations, interfaces, and structures. Platform also contains nested namespaces.

Attribute	Description
Flags	Indicates that an enumeration can be treated as a bit field; that is, a set of flags.
MTAThread	Indicates that the threading model for an application is multi-threaded apartment (MTA).
STAThread	Indicates that the threading model for an application is single-threaded apartment (STA).

Classes

The Platform namespace has the following classes.

Class	Description
Platform::AccessDeniedException Class	Raised when access is denied to a resource or feature.
Platform::Agile Class	Represents a non-agile object as an agile object.
Platform::Array Class	Represents a one-dimensional, modifiable array.
Platform::ArrayReference Class	Represents an array whose initialization is optimized to minimize copying operations.
Platform::Box Class	Used to declare a boxed type that encapsulates a value type such as Windows::Foundation::DateTime or int64 when that type is passed across the application binary interface (ABI) or stored in a variable of type Platform::Object^.
Platform::ChangedStateException Class	Thrown when methods of a collection iterator or a collection view are called after the parent collection has changed, invalidating the results of the method.
Platform::ClassNotRegisteredException Class	Thrown when a COM class has not been registered.
Platform::COMException Class	Represents the exception that is thrown when an unrecognized value is returned from a COM method call.
Platform::Delegate Class	Represents the signature of a callback function.
Platform::DisconnectedException Class	The object has disconnected from its clients.
Platform::Exception Class	Represents errors that occur during application execution. The base class for exceptions.
Platform::FailureException Class	Thrown when the operation has failed. It is the equivalent of the E_FAIL HRESULT.
Platform::Guid value class	Represents a GUID in the Windows Runtime type system.
Platform::InvalidArgumentException Class	Thrown when one of the arguments provided to a method is not valid.
Platform::InvalidCastException Class	Thrown in cases of invalid casting or explicit conversion.
Platform::MTAThreadAttribute Class	Indicates that the threading model for an application is multi-threaded apartment (MTA).
Platform::NotImplementedException Class	Thrown if an interface method has not been implemented on the class.
Platform::NullReferenceException Class	Thrown when there is an attempt to dereference a null object reference.
Platform::Object Class	A base class that provides common behavior.
Platform::ObjectDisposedException Class	Thrown when an operation is performed on a disposed object.
Platform::OperationCanceledException Class	Thrown when an operation is aborted.
Platform::OutOfBoundsException Class	Thrown when an operation attempts to access data outside the valid range.
Platform::OutOfMemoryException Class	Thrown when there's insufficient memory to complete the operation.
Platform::STAThreadAttribute Class	Indicates that the threading model for an application is single-threaded apartment (STA).
Platform::String Class	A sequential collection of Unicode characters that is used to represent text.
Platform::StringReference Class	Enables access to string buffers with minimum of copy overhead.
Platform::Type Class	Identifies a built-in type by a category enumeration.
Platform::ValueType Class	The base class for instances of value types.
Platform::WeakReference Class	Provides a weak reference to ref class objects that does not increment the reference count.
Platform::WriteOnlyArray Class	Represents a one-dimensional write-only array which is used as an input parameter on methods that implement the FillArray pattern.
Platform::WrongThreadException Class	Thrown when a thread calls via an interface pointer which is for a proxy object that does not belong to the thread's apartment.

Interface implementations

The Platform namespace defines the following interfaces.

Interface	Description
Platform::IBox Interface	Used to pass value types to functions whose parameters are typed as Platform::Object^.
Platform::IBoxArray Interface	Interface used to pass arrays of value types to functions whose parameters are typed as Platform::Array.
Platform::IDisposable Interface	Used to release unmanaged resources.

Enumerations

The Platform namespace has the following enumerations.

Interface	Description
Platform::CallbackContext Enumeration	An enumeration that is used as a parameter of the delegate constructor. It determines whether the callback is to be marshalled to the originating thread or to the caller thread.
Platform::TypeCode Enumeration	Specifies a numeric category that represents a built-in type.

Structures

The Platform namespace has the following structures.

Structure	Description
Platform::Enum Class	Represents a named constant.
Platform::Guid value class	Represents a GUID.
Platform::IntPtr value class	A signed pointer whose size is appropriate for the platform (32-bit or 64-bit).
Platform::SizeT value class	An unsigned data type used to represent the size of an object.
Platform::UIntPtr value class	An unsigned pointer whose size is appropriate for the platform (32-bit or 64-bit).

Platform namespace (C++/CX)

Syntax

Members

See also

Feedback

Feedback

Additional resources